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

**type** `string` *required*

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

**data** `object` *required*

Event-specific payload for this webhook.

**Data object parameters**

**profile** `object` *required*

The connected profile.

**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 was connected to. Contains `id`, `slug`, and `name`.

**connectedBy** `object` *required*

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

**connectedAt** `string` *required*

ISO 8601 timestamp when the profile was connected.

**createdAt** `string` *required*

ISO 8601 timestamp when the webhook event was created.

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


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