Skip to content
Ordinal
Esc
↑↓navigate↵open⌘Jpreview

social_profile.reconnect_needed

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

SENDsocial_profile.reconnect_needed
Message
application/json
typestring

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

dataobject

Event-specific payload for this webhook.

Show properties
profileobject

The profile that needs reconnecting.

Show properties
idstring

Profile ID.

namestring | null

Profile display name.

detailstring | null

Profile vanity name or handle.

channelstring

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

profileImageUrlstring | null

URL of the profile image.

typestring

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

urlstring

Optional. Profile URL on the social platform.

workspaceWorkspace

Workspace the profile belongs to. Contains id, slug, and name.

Show properties
idstring<uuid>

Workspace ID.

slugstring

Workspace slug.

namestring

Workspace name.

detectedAtstring<date-time>

ISO 8601 timestamp when the reconnect need was detected.

createdAtstring<date-time>

ISO 8601 timestamp when the webhook event was created.

Message
{
  "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"
}