Articles on: Linkedin And Twitter

LinkedIn/Twitter Contact Matching Behavior

LinkedIn/Twitter Contact Matching Behavior


Purpose


For LinkedIn and Twitter steps to work, SuperSend needs to match contacts to the right profiles. This article explains how matching works, what happens when there's no match, and how to ensure your contacts have the data needed.


How Matching Works


LinkedIn


SuperSend matches contacts to LinkedIn via a LinkedIn profile URL. When a LinkedIn step runs:


  1. If the enrollment is linked to a contact profile (All Contacts / ContactProfile) and the profile has a non-empty linkedin_url, SuperSend uses that URL (normalized) for the action.
  2. Otherwise it uses the linkedin_url on the campaign contact (enrollment) row.
  3. If neither yields a valid URL, the step cannot run for that contact.


Required: At least one of profile or enrollment linkedin_url must be populated. Map a LinkedIn URL column when importing CSV; keeping the profile’s LinkedIn URL up to date in All Contacts applies to all campaigns that use that profile.


Twitter


SuperSend matches contacts to Twitter via the twitter field (Twitter handle). When a Twitter step runs:


  1. SuperSend reads contact.twitter.
  2. If present, it uses that handle for the action (follow, DM, etc.).
  3. If missing, the step cannot run for that contact.


Required: Contact must have twitter populated. Map this when importing.



Failure Reason Codes


When a step can't run, the contact's reason trail shows one of these:


Code

Display

Meaning

NO_LINKEDIN_URL

Missing LinkedIn URL

Contact has no linkedin_url.

INVALID_LINKEDIN_URL

Invalid LinkedIn URL

URL is malformed or wrong format.

NO_LINKEDIN_IDENTITY

No LinkedIn account connected

Sender profile has no LinkedIn identity.

LINKEDIN_NOT_CONNECTED

Not connected on LinkedIn

For message steps: you're not connected to this person yet.

LINKEDIN_ALREADY_CONNECTED

Already connected on LinkedIn

Connection step skipped; you're already connected.

NO_TWITTER_URL

Missing Twitter handle

Contact has no twitter field.



What Happens When There's No Match?


The step is skipped for that contact. The contact does not leave the campaign — they continue based on your Sequence Step Failures setting:


  • Skip step — Contact moves to the next step.
  • Pause contact — Contact is paused; you can add the missing data and resume.
  • Pause campaign — Campaign pauses; you fix the issue and resume.



Ensuring Good Data


  1. CSV import — Map a linkedin_url column (full URL, e.g., https://www.linkedin.com/in/johndoe) and/or twitter column (handle, e.g., johndoe).
  2. Enrichment — Use an enrichment provider to fill LinkedIn/Twitter if your list doesn't have it.
  3. Validation — After import, spot-check a few contacts to ensure URLs are valid and point to the right people.



LinkedIn-Specific Behaviors


  • Connection request step — Requires that you're not already connected. If LINKEDIN_ALREADY_CONNECTED, the step is skipped.
  • Message step — Requires that you're connected. If LINKEDIN_NOT_CONNECTED, the step can't run. Order steps: connection request first, then message.



Expected Result


You understand that LinkedIn steps need linkedin_url and Twitter steps need twitter. You know how to map these on import and what happens when they're missing. You can interpret the reason codes to fix contact data or sender configuration.



Updated on: 03/04/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!