social_profile.reconnect_needed

Fired when a social profile needs to be reconnected (e.g. token expired, permissions revoked)

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.reconnect_needed).

Typestring

dataobject

Event-specific payload for this webhook.

Typeobject

data.profileobject

The profile that needs reconnecting.

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 belongs to. Contains id, slug, and name.

Typeobject

data.profile.detectedAtstring

ISO 8601 timestamp when the reconnect need was detected.

Typestring

createdAtstring

ISO 8601 timestamp when the webhook event was created.

Typestring

{
  "type": "social_profile.reconnect_needed",
  "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"
      },
      "detectedAt": "2025-02-26T09:00:00.000Z"
    }
  },
  "createdAt": "2025-02-26T09:00:00.000Z"
}