> ## Documentation Index
> Fetch the complete documentation index at: https://ordinal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

**type** `string` *required*

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

**data** `object` *required*

Event-specific payload for this webhook.

**Data object parameters**

**profile** `object` *required*

The profile that needs reconnecting.

**Profile object parameters**

**id** `string` *required*

Profile ID.

**name** `string | null`

Profile display name.

**detail** `string | null`

Profile vanity name or handle.

**channel** `string` *required*

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

**profileImageUrl** `string | null`

URL of the profile image.

**type** `string`

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

**url** `string`

Optional. Profile URL on the social platform.

**workspace** `object` *required*

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

**detectedAt** `string` *required*

ISO 8601 timestamp when the reconnect need was detected.

**createdAt** `string` *required*

ISO 8601 timestamp when the webhook event was created.

```json Example theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.