# Accounts API

> Profiles, account groups, connected social accounts and connect flows.

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List profiles

`GET /profiles`

Profiles group connected accounts per brand, client or end customer. Filter by name, external_id or is_default.

Access: `read` · MCP tool: `list-profiles` · Zernio: `GET /v1/profiles`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of name, created_at, updated_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `name` (string)
- `external_id` (string)
- `is_default` (boolean)

```bash
curl "https://api.socialit.com/v1/profiles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "profile",
      "id": "string",
      "name": "string",
      "description": "string",
      "color": "string",
      "timezone": "Europe/Prague",
      "external_id": "string",
      "is_default": true,
      "account_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Create a profile

`POST /profiles`

The first profile of a workspace is the default. external_id is your tenant id (unique per workspace).

Access: `admin` · MCP tool: `create-profile` · Zernio: `POST /v1/profiles`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; 1–100 characters)
- `description` (string | null; ≤ 500 characters)
- `color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB
- `timezone` (string | null; ≤ 64 characters)
- `external_id` (string | null; 1–255 characters)
- `is_default` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/profiles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "color": "string",
    "timezone": "Europe/Prague",
    "external_id": "string"
  }'
```

Response 201:

```json
{
  "object": "profile",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "timezone": "Europe/Prague",
  "external_id": "string",
  "is_default": true,
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Get a profile

`GET /profiles/{id}`

Access: `read` · MCP tool: `get-profile` · Zernio: `GET /v1/profiles/{profileId}`

### Path parameters

- `id` (string; required; 1–80 characters): profile id (pro_…)

```bash
curl "https://api.socialit.com/v1/profiles/pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "profile",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "timezone": "Europe/Prague",
  "external_id": "string",
  "is_default": true,
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update a profile

`PATCH /profiles/{id}`

Set is_default: true to make this the workspace default profile.

Access: `admin` · MCP tool: `update-profile` · Zernio: `PUT /v1/profiles/{profileId}`

### Path parameters

- `id` (string; required; 1–80 characters): profile id (pro_…)

### Body

- `name` (string; 1–100 characters)
- `description` (string | null; ≤ 500 characters)
- `color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB
- `timezone` (string | null; ≤ 64 characters)
- `external_id` (string | null; 1–255 characters)
- `is_default` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/profiles/pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "color": "string",
    "timezone": "Europe/Prague",
    "external_id": "string"
  }'
```

Response 200:

```json
{
  "object": "profile",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "timezone": "Europe/Prague",
  "external_id": "string",
  "is_default": true,
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a profile

`DELETE /profiles/{id}`

Refused with 409 profile_has_accounts while accounts are assigned, unless force=true (the accounts stay connected, unassigned).

Access: `admin` · MCP tool: `delete-profile` · Zernio: `DELETE /v1/profiles/{profileId}`

### Path parameters

- `id` (string; required; 1–80 characters): profile id (pro_…)

### Query parameters

- `force` (boolean)

```bash
curl -X DELETE "https://api.socialit.com/v1/profiles/pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "profile",
  "id": "string",
  "deleted": true
}
```

## List account groups

`GET /account-groups`

Access: `read` · MCP tool: `list-account-groups` · Zernio: `GET /v1/account-groups`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of name, created_at, updated_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string)
- `name` (string)

```bash
curl "https://api.socialit.com/v1/account-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "account_group",
      "id": "string",
      "name": "string",
      "description": "string",
      "color": "string",
      "profile_id": "string",
      "account_ids": [
        "string"
      ],
      "account_count": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Create an account group

`POST /account-groups`

A named collection of accounts for cross-posting and organization, optionally owned by a profile.

Access: `write` · MCP tool: `create-account-group` · Zernio: `POST /v1/account-groups`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `name` (string; required; 1–100 characters)
- `account_ids` (array of string; ≤ 500 items)
- `profile_id` (string | null; ≤ 80 characters)
- `description` (string | null; ≤ 500 characters)
- `color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB

```bash
curl -X POST "https://api.socialit.com/v1/account-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "account_ids": [
      "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "profile_id": "string",
    "description": "string",
    "color": "string"
  }'
```

Response 201:

```json
{
  "object": "account_group",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "profile_id": "string",
  "account_ids": [
    "string"
  ],
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Get an account group

`GET /account-groups/{id}`

Access: `read` · MCP tool: `get-account-group`

### Path parameters

- `id` (string; required; 1–80 characters): group id (grp_…)

```bash
curl "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_group",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "profile_id": "string",
  "account_ids": [
    "string"
  ],
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update an account group

`PATCH /account-groups/{id}`

account_ids replaces the membership.

Access: `write` · MCP tool: `update-account-group` · Zernio: `PUT /v1/account-groups/{groupId}`

### Path parameters

- `id` (string; required; 1–80 characters): group id (grp_…)

### Body

- `name` (string; 1–100 characters)
- `account_ids` (array of string; ≤ 500 items)
- `profile_id` (string | null; ≤ 80 characters)
- `description` (string | null; ≤ 500 characters)
- `color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB

```bash
curl -X PATCH "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "account_ids": [
      "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "profile_id": "string",
    "description": "string",
    "color": "string"
  }'
```

Response 200:

```json
{
  "object": "account_group",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "profile_id": "string",
  "account_ids": [
    "string"
  ],
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete an account group

`DELETE /account-groups/{id}`

Access: `write` · MCP tool: `delete-account-group` · Zernio: `DELETE /v1/account-groups/{groupId}`

### Path parameters

- `id` (string; required; 1–80 characters): group id (grp_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_group",
  "id": "string",
  "deleted": true
}
```

## Add accounts to an account group

`POST /account-groups/{id}/accounts`

Access: `write` · MCP tool: `add-account-group-accounts`

### Path parameters

- `id` (string; required; 1–80 characters): group id (grp_…)

### Body

- `account_ids` (array of string; required; 1–500 items)

```bash
curl -X POST "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": [
      "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ]
  }'
```

Response 200:

```json
{
  "object": "account_group",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "profile_id": "string",
  "account_ids": [
    "string"
  ],
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Remove an account from an account group

`DELETE /account-groups/{id}/accounts/{accountId}`

Access: `write` · MCP tool: `remove-account-group-account`

### Path parameters

- `id` (string; required; 1–80 characters): group id (grp_…)
- `accountId` (string; required; 1–80 characters): socialAccount id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_group",
  "id": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "profile_id": "string",
  "account_ids": [
    "string"
  ],
  "account_count": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## List connected accounts

`GET /accounts`

Filter with platform, profile_id (or none), group_id, status, account_type, search, or <field>.<condition>= filters.

Access: `read` · MCP tool: `list-accounts` · Zernio: `GET /v1/accounts`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at, updated_at, platform, username, display_name, status)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `platform` (string)
- `profile_id` (string): pro_… or none for unassigned accounts
- `group_id` (string)
- `status` (string; one of active, needs_reconnect)
- `account_type` (string; one of profile, page, organization, channel)
- `search` (string; ≤ 200 characters)

```bash
curl "https://api.socialit.com/v1/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Health of every account

`GET /accounts/health`

Summary plus per-account health. live=true probes every token at the network (slower).

Access: `read` · MCP tool: `get-accounts-health` · Zernio: `GET /v1/accounts/health`

### Query parameters

- `profile_id` (string)
- `platform` (string)
- `status` (string; one of healthy, warning, error)
- `live` (boolean)
- `page` (integer; ≥ 1)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/health" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "account_health",
      "account_id": "string",
      "platform": "string",
      "username": "string",
      "display_name": "string",
      "profile_id": "string",
      "status": "healthy",
      "can_post": true,
      "can_fetch_analytics": true,
      "token_valid": true,
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "needs_reconnect": true,
      "token": {
        "valid": true,
        "strategy": "string",
        "expires_at": "2026-10-13T09:00:00.000Z",
        "needs_refresh": true,
        "detail": "string"
      },
      "permissions": {
        "posting": [
          {
            "scope": null,
            "granted": null,
            "required": null
          }
        ],
        "analytics": [
          {
            "scope": null,
            "granted": null,
            "required": null
          }
        ],
        "optional": [
          {
            "scope": null,
            "granted": null,
            "required": null
          }
        ],
        "missing_required": [
          "string"
        ]
      },
      "issues": [
        "string"
      ],
      "recommendations": [
        "string"
      ],
      "live": true,
      "checked_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com",
  "summary": {
    "total": 1,
    "healthy": 1,
    "warning": 1,
    "error": 1,
    "needs_reconnect": 1
  }
}
```

## Follower counts and growth

`GET /accounts/follower-stats`

Daily follower snapshots per account (filled by the analytics sync), bucketed daily, weekly or monthly.

Access: `read` · MCP tool: `get-follower-stats` · Zernio: `GET /v1/accounts/follower-stats`

### Query parameters

- `account_ids` (string): Comma separated sa_… ids
- `profile_id` (string)
- `platform` (string)
- `from_date` (string; pattern ^\d{4}-\d{2}-\d{2}$)
- `to_date` (string; pattern ^\d{4}-\d{2}-\d{2}$)
- `granularity` (string; one of daily, weekly, monthly)

```bash
curl "https://api.socialit.com/v1/accounts/follower-stats" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "follower_stats",
  "date_range": {
    "from_date": "string",
    "to_date": "string"
  },
  "granularity": "daily",
  "accounts": [
    {
      "account_id": "string",
      "platform": "string",
      "username": "string",
      "display_name": "string",
      "current_followers": 1,
      "growth": 1,
      "growth_percentage": 1.5,
      "last_updated": "2026-10-13T09:00:00.000Z",
      "stats": {
        "following": 1,
        "posts_count": 1
      },
      "data_points": [
        {
          "date": "string",
          "followers": 1
        }
      ]
    }
  ]
}
```

## Get an account

`GET /accounts/{id}`

Access: `read` · MCP tool: `get-account`

### Path parameters

- `id` (string; required; 1–80 characters): socialAccount id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account",
  "id": "string",
  "platform": "string",
  "connect_flow": "string",
  "account_type": "profile",
  "profile_id": "string",
  "group_ids": [
    "string"
  ],
  "external_id": "string",
  "parent_external_id": "string",
  "username": "string",
  "name": "string",
  "display_name": "string",
  "avatar_url": "https://example.com",
  "profile_url": "https://example.com",
  "status": "active",
  "is_active": true,
  "needs_reconnect": true,
  "publishing_paused": true,
  "scopes": [
    "string"
  ],
  "token_expires_at": "2026-10-13T09:00:00.000Z",
  "default_config": {},
  "metadata": {},
  "followers_count": 1,
  "followers_updated_at": "2026-10-13T09:00:00.000Z",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update an account or move it to another profile

`PATCH /accounts/{id}`

Local label (name), display_name, username, default_config (per-network publish defaults) and profile_id (move).

Access: `write` · MCP tool: `update-account` · Zernio: `PUT /v1/accounts/{accountId}`, `PATCH /v1/accounts/{accountId}`

### Path parameters

- `id` (string; required; 1–80 characters): socialAccount id (sa_…)

### Body

- `name` (string | null; ≤ 100 characters)
- `display_name` (string | null; ≤ 200 characters)
- `username` (string | null; ≤ 200 characters)
- `profile_id` (string | null; ≤ 80 characters)
- `default_config` (object | null)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "display_name": "string",
    "username": "string",
    "profile_id": "string",
    "default_config": {}
  }'
```

Response 200:

```json
{
  "object": "account",
  "id": "string",
  "platform": "string",
  "connect_flow": "string",
  "account_type": "profile",
  "profile_id": "string",
  "group_ids": [
    "string"
  ],
  "external_id": "string",
  "parent_external_id": "string",
  "username": "string",
  "name": "string",
  "display_name": "string",
  "avatar_url": "https://example.com",
  "profile_url": "https://example.com",
  "status": "active",
  "is_active": true,
  "needs_reconnect": true,
  "publishing_paused": true,
  "scopes": [
    "string"
  ],
  "token_expires_at": "2026-10-13T09:00:00.000Z",
  "default_config": {},
  "metadata": {},
  "followers_count": 1,
  "followers_updated_at": "2026-10-13T09:00:00.000Z",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Disconnect an account

`DELETE /accounts/{id}`

Revokes the token at the network where supported (and no other account shares the grant), then deletes the account.

Access: `write` · MCP tool: `disconnect-account` · Zernio: `DELETE /v1/accounts/{accountId}`

### Path parameters

- `id` (string; required; 1–80 characters): socialAccount id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account",
  "id": "string",
  "deleted": true,
  "token_revoked": true
}
```

## Check the health of an account

`GET /accounts/{id}/health`

Live token probe plus granted-vs-required permissions. A dead token marks the account needs_reconnect.

Access: `read` · MCP tool: `get-account-health` · Zernio: `GET /v1/accounts/{accountId}/health`

### Path parameters

- `id` (string; required; 1–80 characters): socialAccount id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/health" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "account_health",
  "account_id": "string",
  "platform": "string",
  "username": "string",
  "display_name": "string",
  "profile_id": "string",
  "status": "healthy",
  "can_post": true,
  "can_fetch_analytics": true,
  "token_valid": true,
  "token_expires_at": "2026-10-13T09:00:00.000Z",
  "needs_reconnect": true,
  "token": {
    "valid": true,
    "strategy": "string",
    "expires_at": "2026-10-13T09:00:00.000Z",
    "needs_refresh": true,
    "detail": "string"
  },
  "permissions": {
    "posting": [
      {
        "scope": "string",
        "granted": true,
        "required": true
      }
    ],
    "analytics": [
      {
        "scope": "string",
        "granted": true,
        "required": true
      }
    ],
    "optional": [
      {
        "scope": "string",
        "granted": true,
        "required": true
      }
    ],
    "missing_required": [
      "string"
    ]
  },
  "issues": [
    "string"
  ],
  "recommendations": [
    "string"
  ],
  "live": true,
  "checked_at": "2026-10-13T09:00:00.000Z"
}
```

## List posts published on the network

`GET /accounts/{id}/posts`

Recent posts read live from the network, including posts not published through Socialit.

Access: `read` · MCP tool: `list-account-platform-posts` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

- `id` (string; required; 1–80 characters): socialAccount id (sa_…)

### Query parameters

- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "platform_post",
      "id": "string",
      "platform": "string",
      "content": "string",
      "url": "https://example.com",
      "published_at": "2026-10-13T09:00:00.000Z",
      "media_type": "string",
      "thumbnail_url": "https://example.com",
      "metrics": {
        "likes": 1,
        "comments": 1,
        "shares": 1,
        "views": 1
      }
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com",
  "last_updated": "2026-10-13T09:00:00.000Z"
}
```

## List connectable networks

`GET /connect/platforms`

Every connect flow with its connect methods, required inputs and picker step. enabled=true keeps the ones configured on this server.

Access: `read` · MCP tool: `list-connect-platforms`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `enabled` (boolean)

```bash
curl "https://api.socialit.com/v1/connect/platforms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "connect_platform",
      "id": "string",
      "platform": "string",
      "name": "string",
      "enabled": true,
      "connect_type": "string",
      "connect_types": [
        "string"
      ],
      "requires": [
        "string"
      ],
      "selection": "string",
      "scope_sets": [
        "string"
      ]
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Start connecting an account (authorization URL)

`GET /connect/{platform}`

Returns the network authorization URL. After sign-in the network redirects to Socialit, which connects the account (or shows a picker) and sends the browser to redirect_url. headless=true hands multi-target selections to your own picker.

Access: `write` · MCP tool: `get-connect-url` · Zernio: `GET /v1/connect/{platform}`

### Path parameters

- `platform` (string; required; 1–40 characters): Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

### Query parameters

- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `headless` (boolean)
- `scope_set` (string; one of core, focus, revenue, members, content_owner)
- `reconnect_account_id` (string)
- `account_id` (string): Alias of reconnect_account_id
- `login_method` (string; one of instagram_login, facebook_login)
- `instance` (string; ≤ 255 characters)
- `identifier` (string; ≤ 255 characters)
- `locale` (string; ≤ 20 characters)
- `force_reauth` (boolean)
- `content_owner_id` (string; ≤ 100 characters): YouTube CMS content owner
- `discord_mode` (string; one of bot, webhook)
- `guild_id` (string; ≤ 40 characters)

```bash
curl "https://api.socialit.com/v1/connect/PLATFORM" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_url",
  "platform": "string",
  "flow": "string",
  "url": "https://example.com",
  "auth_url": "https://example.com",
  "state": "string",
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Complete a connect flow with code and state

`POST /connect/{platform}`

Headless completion: exchange the authorization code for the state returned by GET /connect/{platform}.

Access: `write` · MCP tool: `complete-connect` · Zernio: `POST /v1/connect/{platform}`

### Path parameters

- `platform` (string; required; 1–40 characters): Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `code` (string; required; 1–4096 characters)
- `state` (string; required; 1–128 characters)
- `iss` (string; ≤ 500 characters)
- `profile_id` (string)
- `guild_id` (string; ≤ 40 characters)
- `permissions` (string; ≤ 40 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/PLATFORM" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "string",
    "state": "string",
    "iss": "string",
    "profile_id": "string",
    "guild_id": "string"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## Connect an account with credentials

`POST /connect/{platform}/credentials`

Bluesky (identifier + app_password), Mastodon (instance + access_token), Discord (webhook_url).

Access: `write` · MCP tool: `connect-with-credentials`

### Path parameters

- `platform` (string; required; 1–40 characters): Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `identifier` (string; ≤ 255 characters)
- `password` (string; ≤ 500 characters)
- `app_password` (string; ≤ 500 characters)
- `auth_factor_token` (string; ≤ 100 characters)
- `service` (string; ≤ 255 characters)
- `instance` (string; ≤ 255 characters)
- `access_token` (string; ≤ 4096 characters)
- `webhook_url` (string; ≤ 500 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/PLATFORM/credentials" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "identifier": "string",
    "password": "string",
    "app_password": "string"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## Get a pending connection

`GET /connect/pending-data`

Targets waiting to be picked after a multi-target sign-in (token from the headless redirect or a picker step).

Access: `write` · MCP tool: `get-pending-connection` · Zernio: `GET /v1/connect/pending-data`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/pending-data" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected targets of a pending connection

`POST /connect/select`

Access: `write` · MCP tool: `select-pending-connection`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; required; 1–128 characters): Pending connection token (cpt_…)
- `target_ids` (array of string; 1–500 items)
- `board_id` (string; ≤ 100 characters)
- `board_name` (string; ≤ 200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/select" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "target_ids": [
      "string"
    ],
    "board_id": "string",
    "board_name": "string"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List FacebookPage targets of a pending connection

`GET /connect/facebook/select-page`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-facebook-page-connect-targets` · Zernio: `GET /v1/connect/facebook/select-page`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/facebook/select-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected FacebookPage targets

`POST /connect/facebook/select-page`

Access: `write` · MCP tool: `select-facebook-page-connect-targets` · Zernio: `POST /v1/connect/facebook/select-page`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `page_ids` (array of string; ≤ 500 items)
- `page_id` (string; ≤ 100 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/facebook/select-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "target_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List InstagramAccount targets of a pending connection

`GET /connect/instagram/select-account`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-instagram-account-connect-targets` · Zernio: `GET /v1/connect/instagram/select-account`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/instagram/select-account" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected InstagramAccount targets

`POST /connect/instagram/select-account`

Access: `write` · MCP tool: `select-instagram-account-connect-targets` · Zernio: `POST /v1/connect/instagram/select-account`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `account_ids` (array of string; ≤ 500 items)
- `page_ids` (array of string; ≤ 500 items)
- `page_id` (string; ≤ 100 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/instagram/select-account" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "target_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List LinkedinOrganization targets of a pending connection

`GET /connect/linkedin/organizations`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-linkedin-organization-connect-targets` · Zernio: `GET /v1/connect/linkedin/organizations`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/linkedin/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected LinkedinOrganization targets

`POST /connect/linkedin/select-organization`

Access: `write` · MCP tool: `select-linkedin-organization-connect-targets` · Zernio: `POST /v1/connect/linkedin/select-organization`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `organization_ids` (array of string; ≤ 500 items)
- `include_personal` (boolean)
- `selections` (array of object; ≤ 200 items)
  - `selections[].account_type` (string; one of personal, organization)
  - `selections[].organization_id` (string; ≤ 200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/linkedin/select-organization" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "target_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List PinterestBoard targets of a pending connection

`GET /connect/pinterest/select-board`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-pinterest-board-connect-targets` · Zernio: `GET /v1/connect/pinterest/select-board`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/pinterest/select-board" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected PinterestBoard targets

`POST /connect/pinterest/select-board`

Access: `write` · MCP tool: `select-pinterest-board-connect-targets` · Zernio: `POST /v1/connect/pinterest/select-board`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `board_id` (string; required; ≤ 100 characters)
- `board_name` (string; ≤ 200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/pinterest/select-board" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "board_id": "string"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List GoogleBusinessLocation targets of a pending connection

`GET /connect/googlebusiness/locations`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-google-business-location-connect-targets` · Zernio: `GET /v1/connect/googlebusiness/locations`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/googlebusiness/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected GoogleBusinessLocation targets

`POST /connect/googlebusiness/select-location`

Access: `write` · MCP tool: `select-google-business-location-connect-targets` · Zernio: `POST /v1/connect/googlebusiness/select-location`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `location_ids` (array of string; ≤ 500 items)
- `location_id` (string; ≤ 200 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/googlebusiness/select-location" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "target_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List SnapchatProfile targets of a pending connection

`GET /connect/snapchat/select-profile`

Targets found after the network sign-in, to render your own picker (headless connect). Pass the pending token as token or the X-Connect-Token header.

Access: `write` · MCP tool: `list-snapchat-profile-connect-targets` · Zernio: `GET /v1/connect/snapchat/select-profile`

### Query parameters

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)

```bash
curl "https://api.socialit.com/v1/connect/snapchat/select-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_pending",
  "token": "string",
  "platform": "string",
  "flow": "string",
  "profile_id": "string",
  "step": "string",
  "multiple": true,
  "user_profile": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com"
  },
  "targets": [
    {
      "id": "string",
      "account_type": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "already_connected": true,
      "account_id": "string",
      "details": {}
    }
  ],
  "options": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "string"
    }
  ],
  "expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Connect the selected SnapchatProfile targets

`POST /connect/snapchat/select-profile`

Access: `write` · MCP tool: `select-snapchat-profile-connect-targets` · Zernio: `POST /v1/connect/snapchat/select-profile`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `pending_token` (string; 1–128 characters): Pending connection token (cpt_…)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `target_ids` (array of string; ≤ 500 items)
- `public_profile_id` (string; ≤ 100 characters)

```bash
curl -X POST "https://api.socialit.com/v1/connect/snapchat/select-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "pending_token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "profile_id": "string",
    "redirect_url": "https://example.com",
    "target_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## Connect Bluesky with an app password

`POST /connect/bluesky/credentials`

Access: `write` · MCP tool: `connect-bluesky-credentials` · Zernio: `POST /v1/connect/bluesky/credentials`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `identifier` (string; required; 1–255 characters)
- `app_password` (string; 1–500 characters)
- `password` (string; 1–500 characters)
- `auth_factor_token` (string; ≤ 100 characters)
- `profile_id` (string)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `state` (string; ≤ 200 characters): Ignored (Zernio compatibility)

```bash
curl -X POST "https://api.socialit.com/v1/connect/bluesky/credentials" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "string",
    "app_password": "string",
    "password": "string",
    "auth_factor_token": "string",
    "profile_id": "string"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## Connect Discord channels

`POST /connect/discord`

Bind channels of a guild where the Socialit bot is installed (or of a pending Discord install token).

Access: `write` · MCP tool: `connect-discord-channels` · Zernio: `POST /v1/connect/discord`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `guild_id` (string; ≤ 40 characters)
- `channel_id` (string; ≤ 40 characters)
- `channel_ids` (array of string; ≤ 25 items)
- `profile_id` (string)
- `token` (string; 1–128 characters): Pending connection token (cpt_…)
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme

```bash
curl -X POST "https://api.socialit.com/v1/connect/discord" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "guild_id": "string",
    "channel_id": "string",
    "channel_ids": [
      "string"
    ],
    "profile_id": "string",
    "token": "cpt_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
  }'
```

Response 200:

```json
{
  "object": "connect_result",
  "status": "connected",
  "platform": "string",
  "profile_id": "string",
  "accounts": [
    {
      "object": "account",
      "id": "string",
      "platform": "string",
      "connect_flow": "string",
      "account_type": "profile",
      "profile_id": "string",
      "group_ids": [
        "string"
      ],
      "external_id": "string",
      "parent_external_id": "string",
      "username": "string",
      "name": "string",
      "display_name": "string",
      "avatar_url": "https://example.com",
      "profile_url": "https://example.com",
      "status": "active",
      "is_active": true,
      "needs_reconnect": true,
      "publishing_paused": true,
      "scopes": [
        "string"
      ],
      "token_expires_at": "2026-10-13T09:00:00.000Z",
      "default_config": {},
      "metadata": {},
      "followers_count": 1,
      "followers_updated_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "failed": [
    {
      "id": "string",
      "code": "string",
      "message": "string"
    }
  ],
  "pending": {
    "object": "connect_pending",
    "token": "string",
    "platform": "string",
    "flow": "string",
    "profile_id": "string",
    "step": "string",
    "multiple": true,
    "user_profile": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com"
    },
    "targets": [
      {
        "id": "string",
        "account_type": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "already_connected": true
      }
    ],
    "options": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "privacy": "string"
      }
    ],
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "redirect_url": "https://example.com"
}
```

## List hosted connect links

`GET /connect/links`

Access: `admin` · MCP tool: `list-connect-links`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at, expires_at, name)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string)
- `status` (string; one of active, expired, revoked, exhausted)

```bash
curl "https://api.socialit.com/v1/connect/links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "connect_link",
      "id": "string",
      "name": "string",
      "profile_id": "string",
      "url": "https://example.com",
      "platforms": [
        "string"
      ],
      "branding": {
        "name": "string",
        "logo_url": "https://example.com",
        "primary_color": "string",
        "accent_color": "string",
        "background_color": "string"
      },
      "redirect_url": "https://example.com",
      "status": "active",
      "max_uses": 1,
      "use_count": 1,
      "last_used_at": "2026-10-13T09:00:00.000Z",
      "expires_at": "2026-10-13T09:00:00.000Z",
      "revoked_at": "2026-10-13T09:00:00.000Z",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Create a hosted connect link

`POST /connect/links`

A branded page where your customer connects their accounts to one profile, then lands on redirect_url with account_ids.

Access: `admin` · MCP tool: `create-connect-link`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `profile_id` (string; required)
- `name` (string | null; ≤ 100 characters)
- `platforms` (array of string | null; ≤ 40 items)
- `branding` (object)
  - `branding.name` (string | null; ≤ 60 characters)
  - `branding.logo_url` (string | null; ≤ 1000 characters)
  - `branding.primary_color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB
  - `branding.accent_color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB
  - `branding.background_color` (string | null; pattern ^#[0-9A-Fa-f]{6}$): Hex color #RRGGBB
- `redirect_url` (string | null; ≤ 2000 characters): Absolute http(s) URL or app scheme
- `expires_in` (integer; 300–2592000)
- `expires_at` (string (date-time))
- `max_uses` (integer | null; 1–10000)

```bash
curl -X POST "https://api.socialit.com/v1/connect/links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "string",
    "name": "string",
    "platforms": [
      "string"
    ],
    "branding": {
      "name": "string",
      "logo_url": "https://example.com"
    },
    "redirect_url": "https://example.com"
  }'
```

Response 201:

```json
{
  "object": "connect_link",
  "id": "string",
  "name": "string",
  "profile_id": "string",
  "url": "https://example.com",
  "platforms": [
    "string"
  ],
  "branding": {
    "name": "string",
    "logo_url": "https://example.com",
    "primary_color": "string",
    "accent_color": "string",
    "background_color": "string"
  },
  "redirect_url": "https://example.com",
  "status": "active",
  "max_uses": 1,
  "use_count": 1,
  "last_used_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "revoked_at": "2026-10-13T09:00:00.000Z",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Get a hosted connect link

`GET /connect/links/{id}`

Access: `admin` · MCP tool: `get-connect-link`

### Path parameters

- `id` (string; required; 1–80 characters): connectLink id (cl_…)

```bash
curl "https://api.socialit.com/v1/connect/links/cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_link",
  "id": "string",
  "name": "string",
  "profile_id": "string",
  "url": "https://example.com",
  "platforms": [
    "string"
  ],
  "branding": {
    "name": "string",
    "logo_url": "https://example.com",
    "primary_color": "string",
    "accent_color": "string",
    "background_color": "string"
  },
  "redirect_url": "https://example.com",
  "status": "active",
  "max_uses": 1,
  "use_count": 1,
  "last_used_at": "2026-10-13T09:00:00.000Z",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "revoked_at": "2026-10-13T09:00:00.000Z",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Revoke a hosted connect link

`DELETE /connect/links/{id}`

Access: `admin` · MCP tool: `revoke-connect-link`

### Path parameters

- `id` (string; required; 1–80 characters): connectLink id (cl_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/connect/links/cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "connect_link",
  "id": "string",
  "deleted": true
}
```


---

Source: https://socialit.com/docs/api-reference/accounts/
