# Integration

Object

A connected social account for the workspace. Each entry represents one connected account, distinct from `Workspace.mentions`, which lists tracked @-mention terms. Multiple integrations may share the same `handle` (e.g. two TikTok accounts under one tag) and each gets a distinct `id`.

## Fields

| Name | Type | Description |
| --- | --- | --- |
| `connectedAt` | [`DateTimeWithZone!`](/api/v2/docs/types/date-time-with-zone) | Timestamp when the integration was first established (ISO 8601 UTC). |
| `handle` | `String!` | Public-facing account handle for this integration (for example "support_testing"). Sourced from the associated mention tag. |
| `id` | `ID!` | Stable unique identifier for this integration (UUID). Distinguishes multiple integrations that share the same handle. |
| `provider` | [`Provider!`](/api/v2/docs/types/provider) | Platform on which this account is connected (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL). |
| `status` | [`IntegrationStatus!`](/api/v2/docs/types/integration-status) | Lifecycle state of the integration. CONNECTED = active and verified; DISCONNECTED = the account was removed or the integration failed; PENDING = setup in progress. |