DocumentationAPI Reference

New Connection

The New Connection Webhook in Salesflow notifies you about new relations in connected account . It helps you stay updated and trigger further actions.

Event Type: NEW_CONNECTION

Note: Due to LinkedIn’s limitations, this webhook is not real-time. Salesflow polls the LinkedIn relationship list at randomized intervals to mimic human behavior and stay within platform rules. The event may be delayed by up to 6 hours after the actual connection is accepted.

How to use wehook New Connections

  1. Track your sent invites

  2. Listen to NEW_CONNECTION webhook

  3. Compare recent entries with your sent invites

Analyze and understand where invite is accepted

Salesflow includes a signature (e.g., in a header x-webhook-secret) .

Each object in the NEW_CONNECTION array represents one new LinkedIn connection.

Payload of Notification 

{
  "EventType": "NEW_CONNECTION",
  "Payload": {
    "Data": {
      "Connections": [
        {
          "ConnectedAt": "2025-08-05T20:15:23Z",
          "Profile": {
            "LinkedInMemberId": 342401755,
            "ProfileId": "ACoAABRqAmsKD_LS16s6JlNkuv7mP_EQ2cuA",
            "FirstName": "Test",
            "LastName": "Testovenko",
            "PublicIdentifier": "ange-test-diagou-2b784996",
            "Occupation": "Technology Entrepreneur #datacenter #cloud #telecom #cybersécurité #insurance #bank #database #business intelligence #ai",
            "BackgroundPictureUrl": "https://media.licdn.com/dms/image/v2/D4E16AQFuBLxfdlxjXg/profile-displaybackgroundimage-shrink_350_1400/profile-displaybackgroundimage-shrink_350_1400/0/1733163719944?e=1757548800&v=beta&t=MaFRVgfy_oHLwAEz5yC2Tgqy1-EGPxrI7OgAS1OBCrQ",
            "ProfilePictureUrl": "https://media.licdn.com/dms/image/v2/D4E03AQGiWe1LjAlhEg/profile-displayphoto-shrink_100_100/B4EZb.EJZ5HQAU-/0/1748019222906?e=1757548800&v=beta&t=vDjlTMWmBjF4hwLIfi0HD_j947sK1EQVDc7mvnzyBDY",
            "ProfilePictureUrlLarge": "https://media.licdn.com/dms/image/v2/D4E03AQGiWe1LjAlhEg/profile-displayphoto-shrink_800_800/B4EZb.EJZ5HQAc-/0/1748019222996?e=1757548800&v=beta&t=YRwRIKufurZvVKJMpX74x5S9UXOfZE3ojEzD3FZZaFg"
          }
        }
      ]
    },
    "SyncFinished": true
  },
  "LinkedInAccountId": 8969,
  "LinkedInEmail": "josiane.delport34@laposte.net"
}

Values of Connection payload

Field

Type

Description

ConnectedAt

date

The date and time when the connection was established (UTC).

LinkedInMemberId

int64

Internal LinkedIn ID of the connected user. Unique per profile.

ProfileId

string

Internal LinkedIn profile ID. Can be used to identify the user in LinkedIn systems. Not unique.

FirstName

string | null

User’s first name.

LastName

string | null

User’s last name.

PublicIdentifier

string | null

Public part of the LinkedIn profile URL (e.g. john-doe-123abc). Not unique. Can be used to construct a public profile URL: https://www.linkedin.com/in/{PublicIdentifier}

Occupation

string | null

User's current job title or headline.

BackgroundPictureUrl

string | null

URL to the user's LinkedIn background image (if available).

ProfilePictureUrl

string | null

URL to a small-size profile photo.

ProfilePictureUrlLarge

string | null

URL to a larger-size profile photo.

Alternative (For Connection request with Notes)

When a LinkedIn invite includes a message, the resulting connection creates a new chat containing that message. Salesflow's New Messages Webhook can be used to detect connection as well

Check Documentation : Webhooks Triggers > New Messages

Make sure that system make comparison based on LinkedInMemberId

Alternative (Without webhooks)

You can set up Polling Strategy by yourself

  1. Track your sent invites

  2. Periodically poll the relationship list (Get/api/v1/connections), sorted by most recent (sort type = 2)

  3. Compare recent entries with your sent invites

Make sure that system make comparison based on LinkedInMemberId

You can also use Salesflow’s API to:

  • Retrieve your sent invitations GET/api/v1/invitations/sent

  • Detect when invitations are no longer in “pending” state

  • Use the Retrieve a LinkedIn Profile (GET/api/v1/profiles/{id}) endpoint to confirm connection status

Tip: To avoid triggering LinkedIn’s rate limits or automation flags, perform these checks only a few times per day, and use randomized delays.

Use cases

1. Track Accepted Invites

Compare NEW_CONNECTION webhook data with your sent invites to detect which invites were accepted.

2. Trigger Workflows on New Connection

Use the webhook to start CRM or email sequences when a new contact is added.

3. Update Contact Info Automatically

Sync new contact’s name, title, and profile data to your system using webhook payload.

4. Analyze Outreach Sequences

Analyze accepted connections to measure outreach success.

5. Sync to External Tools

Push new connection data to CRM, Airtable, HubSpot, or Google Sheets.