social_profile.connected

Fired when a social profile is connected to the workspace

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

PropType

typestring

The event type (e.g. social_profile.connected).

Typestring

dataobject

Event-specific payload for this webhook.

Typeobject

data.profileobject

The connected profile.

Typeobject

data.profile.idstring

Profile ID.

Typestring

data.profile.name?string | null

Profile display name.

Typestring | null

data.profile.detail?string | null

Profile vanity name or handle.

Typestring | null

data.profile.channelstring

Social channel (e.g. LinkedIn, Twitter).

Typestring

data.profile.profileImageUrl?string | null

URL of the profile image.

Typestring | null

data.profile.type?string

Optional. LinkedIn account type (e.g. Company, Personal).

Typestring

data.profile.url?string

Optional. Profile URL on the social platform.

Typestring

data.profile.workspaceobject

Workspace the profile was connected to. Contains id, slug, and name.

Typeobject

data.profile.connectedByobject

User who connected the profile. Contains id, firstName, lastName, and email.

Typeobject

data.profile.connectedAtstring

ISO 8601 timestamp when the profile was connected.

Typestring

createdAtstring

ISO 8601 timestamp when the webhook event was created.

Typestring

{
  "type": "social_profile.connected",
  "data": {
    "profile": {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Acme Inc",
      "detail": "acme-inc",
      "channel": "LinkedIn",
      "profileImageUrl": "https://cdn.tryordinal.com/profiles/acme.png",
      "workspace": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "slug": "acme",
        "name": "Acme Inc"
      },
      "connectedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane@example.com"
      },
      "connectedAt": "2025-02-26T10:00:00.000Z"
    }
  },
  "createdAt": "2025-02-26T10:00:00.000Z"
}