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
SuperSend matches contacts to LinkedIn via the linkedin_url field. When a LinkedIn step runs:
- SuperSend reads
contact.linkedin_url. - If present and valid, it uses that URL to perform the action (connection request, message, etc.).
- If missing or invalid, the step cannot run for that contact.
Required: Contact must have linkedin_url populated. Map this column when importing your CSV (e.g., from a LinkedIn URL column).
SuperSend matches contacts to Twitter via the twitter field (Twitter handle). When a Twitter step runs:
- SuperSend reads
contact.twitter. - If present, it uses that handle for the action (follow, DM, etc.).
- 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 |
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 |
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
- CSV import — Map a
linkedin_urlcolumn (full URL, e.g.,https://www.linkedin.com/in/johndoe) and/ortwittercolumn (handle, e.g.,johndoe). - Enrichment — Use an enrichment provider to fill LinkedIn/Twitter if your list doesn't have it.
- 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.
Related Articles
Updated on: 17/03/2026
Thank you!