Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits44 endpointsMCP toolset accounts

Profiles

List profiles

GET/profiles

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

Access: readZernio: GET /v1/profiles

Try it with MCPAsk your agent to call list-profiles (toolset accounts)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

namecreated_atupdated_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

namestring
external_idstring
is_defaultboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
objectstringrequired

profile

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
timezonestring | null
external_idstring | null
is_defaultbooleanrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/profiles
curl "https://api.socialit.com/v1/profiles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: adminIdempotency-KeyZernio: POST /v1/profiles

Try it with MCPAsk your agent to call create-profile (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

namestringrequired

1–100 characters

descriptionstring | null

≤ 500 characters

colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

timezonestring | null

≤ 64 characters

external_idstring | null

1–255 characters

is_defaultboolean

Returns object

objectstringrequired

profile

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
timezonestring | null
external_idstring | null
is_defaultbooleanrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/profiles
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
{
  "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: readZernio: GET /v1/profiles/{profileId}

Try it with MCPAsk your agent to call get-profile (toolset accounts)Set up MCP

Path parameters

idstringrequired

profile id (pro_…)

1–80 characters

Returns object

objectstringrequired

profile

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
timezonestring | null
external_idstring | null
is_defaultbooleanrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/profiles/{id}
curl "https://api.socialit.com/v1/profiles/pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: adminZernio: PUT /v1/profiles/{profileId}

Try it with MCPAsk your agent to call update-profile (toolset accounts)Set up MCP

Path parameters

idstringrequired

profile id (pro_…)

1–80 characters

Body object

namestring

1–100 characters

descriptionstring | null

≤ 500 characters

colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

timezonestring | null

≤ 64 characters

external_idstring | null

1–255 characters

is_defaultboolean

Returns object

objectstringrequired

profile

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
timezonestring | null
external_idstring | null
is_defaultbooleanrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/profiles/{id}
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
{
  "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: adminZernio: DELETE /v1/profiles/{profileId}

Try it with MCPAsk your agent to call delete-profile (toolset accounts)Set up MCP

Path parameters

idstringrequired

profile id (pro_…)

1–80 characters

Query parameters

forcebooleandefault: false

Returns object

objectstringrequired

profile

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/profiles/{id}
curl -X DELETE "https://api.socialit.com/v1/profiles/pro_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "profile",
  "id": "string",
  "deleted": true
}

Account groups

List account groups

GET/account-groups

Access: readZernio: GET /v1/account-groups

Try it with MCPAsk your agent to call list-account-groups (toolset accounts)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

namecreated_atupdated_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring
namestring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/account-groups
curl "https://api.socialit.com/v1/account-groups" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/account-groups

Try it with MCPAsk your agent to call create-account-group (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

namestringrequired

1–100 characters

account_idsarray of string

≤ 500 items

profile_idstring | null

≤ 80 characters

descriptionstring | null

≤ 500 characters

colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

Returns object

objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/account-groups
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
{
  "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

Try it with MCPAsk your agent to call get-account-group (toolset accounts)Set up MCP

Path parameters

idstringrequired

group id (grp_…)

1–80 characters

Returns object

objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/account-groups/{id}
curl "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeZernio: PUT /v1/account-groups/{groupId}

Try it with MCPAsk your agent to call update-account-group (toolset accounts)Set up MCP

Path parameters

idstringrequired

group id (grp_…)

1–80 characters

Body object

namestring

1–100 characters

account_idsarray of string

≤ 500 items

profile_idstring | null

≤ 80 characters

descriptionstring | null

≤ 500 characters

colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

Returns object

objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/account-groups/{id}
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
{
  "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: writeZernio: DELETE /v1/account-groups/{groupId}

Try it with MCPAsk your agent to call delete-account-group (toolset accounts)Set up MCP

Path parameters

idstringrequired

group id (grp_…)

1–80 characters

Returns object

objectstringrequired

account_group

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/account-groups/{id}
curl -X DELETE "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "account_group",
  "id": "string",
  "deleted": true
}

Add accounts to an account group

POST/account-groups/{id}/accounts

Access: write

Try it with MCPAsk your agent to call add-account-group-accounts (toolset accounts)Set up MCP

Path parameters

idstringrequired

group id (grp_…)

1–80 characters

Body object

account_idsarray of stringrequired

1–500 items

Returns object

objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/account-groups/{id}/accounts
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
{
  "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

Try it with MCPAsk your agent to call remove-account-group-account (toolset accounts)Set up MCP

Path parameters

idstringrequired

group id (grp_…)

1–80 characters

accountIdstringrequired

socialAccount id (sa_…)

1–80 characters

Returns object

objectstringrequired

account_group

idstringrequired
namestringrequired
descriptionstring | null
colorstring | null
profile_idstring | null
account_idsarray of stringrequired
account_countinteger
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/account-groups/{id}/accounts/{accountId}
curl -X DELETE "https://api.socialit.com/v1/account-groups/grp_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

Accounts

List connected accounts

GET/accounts

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

Access: readZernio: GET /v1/accounts

Try it with MCPAsk your agent to call list-accounts (toolset accounts)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atupdated_atplatformusernamedisplay_namestatus

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

platformstring
profile_idstring

pro_… or none for unassigned accounts

group_idstring
statusstring

activeneeds_reconnect

account_typestring

profilepageorganizationchannel

searchstring

≤ 200 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts
curl "https://api.socialit.com/v1/accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

Get an account

GET/accounts/{id}

Access: read

Try it with MCPAsk your agent to call get-account (toolset accounts)Set up MCP

Path parameters

idstringrequired

socialAccount id (sa_…)

1–80 characters

Returns object

objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{id}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeZernio: PUT /v1/accounts/{accountId}PATCH /v1/accounts/{accountId}

Try it with MCPAsk your agent to call update-account (toolset accounts)Set up MCP

Path parameters

idstringrequired

socialAccount id (sa_…)

1–80 characters

Body object

namestring | null

≤ 100 characters

display_namestring | null

≤ 200 characters

usernamestring | null

≤ 200 characters

profile_idstring | null

≤ 80 characters

default_configobject | null

Returns object

objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{id}
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
{
  "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: writeZernio: DELETE /v1/accounts/{accountId}

Try it with MCPAsk your agent to call disconnect-account (toolset accounts)Set up MCP

Path parameters

idstringrequired

socialAccount id (sa_…)

1–80 characters

Returns object

objectstringrequired

account

idstringrequired
deletedbooleanrequired
token_revokedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{id}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: readZernio: GET /v1/accounts/{accountId}/health

Try it with MCPAsk your agent to call get-account-health (toolset accounts)Set up MCP

Path parameters

idstringrequired

socialAccount id (sa_…)

1–80 characters

Returns object

objectstringrequired

account_health

account_idstringrequired
platformstring
usernamestring | null
display_namestring | null
profile_idstring | null
statusstringrequired

healthywarningerror

can_postboolean
can_fetch_analyticsboolean
token_validboolean | null
token_expires_atstring (date-time) | null
needs_reconnectboolean
tokenobject
Show 5 child attributes
validboolean | null
strategystring
expires_atstring (date-time) | null
needs_refreshboolean
detailstring | null
permissionsobject
Show 4 child attributes
postingarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
analyticsarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
optionalarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
missing_requiredarray of string
issuesarray of string
recommendationsarray of string
liveboolean
checked_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{id}/health
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/health" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call list-account-platform-posts (toolset accounts)Set up MCP

Path parameters

idstringrequired

socialAccount id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
objectstringrequired

platform_post

idstringrequired
platformstring
contentstring | null
urlstring | null
published_atstring (date-time) | null
media_typestring | null
thumbnail_urlstring | null
metricsobject | null
Show 4 child attributes
likesinteger | null
commentsinteger | null
sharesinteger | null
viewsinteger | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
last_updatedstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{id}/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}

Health

Health of every account

GET/accounts/health

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

Access: readZernio: GET /v1/accounts/health

Try it with MCPAsk your agent to call get-accounts-health (toolset accounts)Set up MCP

Query parameters

profile_idstring
platformstring
statusstring

healthywarningerror

livebooleandefault: false
pageintegerdefault: 1

≥ 1

limitintegerdefault: 20

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
objectstringrequired

account_health

account_idstringrequired
platformstring
usernamestring | null
display_namestring | null
profile_idstring | null
statusstringrequired

healthywarningerror

can_postboolean
can_fetch_analyticsboolean
token_validboolean | null
token_expires_atstring (date-time) | null
needs_reconnectboolean
tokenobject
Show 5 child attributes
validboolean | null
strategystring
expires_atstring (date-time) | null
needs_refreshboolean
detailstring | null
permissionsobject
Show 4 child attributes
postingarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
analyticsarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
optionalarray of object
Show 3 item attributes
scopestring
grantedboolean
requiredboolean
missing_requiredarray of string
issuesarray of string
recommendationsarray of string
liveboolean
checked_atstring (date-time)
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
summaryobject
Show 5 child attributes
totalinteger
healthyinteger
warninginteger
errorinteger
needs_reconnectinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/health
curl "https://api.socialit.com/v1/accounts/health" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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 stats

Follower counts and growth

GET/accounts/follower-stats

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

Access: readZernio: GET /v1/accounts/follower-stats

Try it with MCPAsk your agent to call get-follower-stats (toolset accounts)Set up MCP

Query parameters

account_idsstring

Comma separated sa_… ids

profile_idstring
platformstring
from_datestring

pattern ^\d{4}-\d{2}-\d{2}$

to_datestring

pattern ^\d{4}-\d{2}-\d{2}$

granularitystringdefault: "daily"

dailyweeklymonthly

Returns object

objectstringrequired

follower_stats

date_rangeobject
Show 2 child attributes
from_datestring
to_datestring
granularitystring

dailyweeklymonthly

accountsarray of objectrequired
Show 10 item attributes
account_idstring
platformstring
usernamestring | null
display_namestring | null
current_followersinteger | null
growthinteger
growth_percentagenumber
last_updatedstring (date-time) | null
statsobject
Show 2 child attributes
followinginteger | null
posts_countinteger | null
data_pointsarray of object
Show 2 item attributes
datestring
followersinteger | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/follower-stats
curl "https://api.socialit.com/v1/accounts/follower-stats" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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
        }
      ]
    }
  ]
}

Connect

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

Try it with MCPAsk your agent to call list-connect-platforms (toolset accounts)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring
orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

enabledboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
objectstring

connect_platform

idstring
platformstring
namestring
enabledboolean
connect_typestring
connect_typesarray of string
requiresarray of string
selectionstring | null
scope_setsarray of string
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/platforms
curl "https://api.socialit.com/v1/connect/platforms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeZernio: GET /v1/connect/{platform}

Try it with MCPAsk your agent to call get-connect-url (toolset accounts)Set up MCP

Path parameters

platformstringrequired

Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

1–40 characters

Query parameters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

headlessbooleandefault: false
scope_setstring

corefocusrevenuememberscontent_owner

reconnect_account_idstring
account_idstring

Alias of reconnect_account_id

login_methodstring

instagram_loginfacebook_login

instancestring

≤ 255 characters

identifierstring

≤ 255 characters

localestring

≤ 20 characters

force_reauthboolean
content_owner_idstring

YouTube CMS content owner

≤ 100 characters

discord_modestring

botwebhook

guild_idstring

≤ 40 characters

Returns object

objectstringrequired

connect_url

platformstring
flowstring
urlstringrequired
auth_urlstring
statestringrequired
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/{platform}
curl "https://api.socialit.com/v1/connect/PLATFORM" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/{platform}

Try it with MCPAsk your agent to call complete-connect (toolset accounts)Set up MCP

Path parameters

platformstringrequired

Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

1–40 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

codestringrequired

1–4096 characters

statestringrequired

1–128 characters

issstring

≤ 500 characters

profile_idstring
guild_idstring

≤ 40 characters

permissionsstring

≤ 40 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/{platform}
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
{
  "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: writeIdempotency-Key

Try it with MCPAsk your agent to call connect-with-credentials (toolset accounts)Set up MCP

Path parameters

platformstringrequired

Network or connect flow (x, facebook, linkedin_org, googlebusiness…)

1–40 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

identifierstring

≤ 255 characters

passwordstring

≤ 500 characters

app_passwordstring

≤ 500 characters

auth_factor_tokenstring

≤ 100 characters

servicestring

≤ 255 characters

instancestring

≤ 255 characters

access_tokenstring

≤ 4096 characters

webhook_urlstring

≤ 500 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/{platform}/credentials
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
{
  "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: writeZernio: GET /v1/connect/pending-data

Try it with MCPAsk your agent to call get-pending-connection (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/pending-data
curl "https://api.socialit.com/v1/connect/pending-data" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-Key

Try it with MCPAsk your agent to call select-pending-connection (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstringrequired

Pending connection token (cpt_…)

1–128 characters

target_idsarray of string

1–500 items

board_idstring

≤ 100 characters

board_namestring

≤ 200 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/select
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
{
  "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: writeZernio: GET /v1/connect/facebook/select-page

Try it with MCPAsk your agent to call list-facebook-page-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/facebook/select-page
curl "https://api.socialit.com/v1/connect/facebook/select-page" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/facebook/select-page

Try it with MCPAsk your agent to call select-facebook-page-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

page_idsarray of string

≤ 500 items

page_idstring

≤ 100 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/facebook/select-page
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
{
  "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: writeZernio: GET /v1/connect/instagram/select-account

Try it with MCPAsk your agent to call list-instagram-account-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/instagram/select-account
curl "https://api.socialit.com/v1/connect/instagram/select-account" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/instagram/select-account

Try it with MCPAsk your agent to call select-instagram-account-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

account_idsarray of string

≤ 500 items

page_idsarray of string

≤ 500 items

page_idstring

≤ 100 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/instagram/select-account
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
{
  "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: writeZernio: GET /v1/connect/linkedin/organizations

Try it with MCPAsk your agent to call list-linkedin-organization-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/linkedin/organizations
curl "https://api.socialit.com/v1/connect/linkedin/organizations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/linkedin/select-organization

Try it with MCPAsk your agent to call select-linkedin-organization-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

organization_idsarray of string

≤ 500 items

include_personalboolean
selectionsarray of object

≤ 200 items

Show 2 item attributes
account_typestring

personalorganization

organization_idstring

≤ 200 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/linkedin/select-organization
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
{
  "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: writeZernio: GET /v1/connect/pinterest/select-board

Try it with MCPAsk your agent to call list-pinterest-board-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/pinterest/select-board
curl "https://api.socialit.com/v1/connect/pinterest/select-board" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/pinterest/select-board

Try it with MCPAsk your agent to call select-pinterest-board-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

board_idstringrequired

≤ 100 characters

board_namestring

≤ 200 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/pinterest/select-board
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
{
  "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: writeZernio: GET /v1/connect/googlebusiness/locations

Try it with MCPAsk your agent to call list-google-business-location-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/googlebusiness/locations
curl "https://api.socialit.com/v1/connect/googlebusiness/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/googlebusiness/select-location

Try it with MCPAsk your agent to call select-google-business-location-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

location_idsarray of string

≤ 500 items

location_idstring

≤ 200 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/googlebusiness/select-location
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
{
  "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: writeZernio: GET /v1/connect/snapchat/select-profile

Try it with MCPAsk your agent to call list-snapchat-profile-connect-targets (toolset accounts)Set up MCP

Query parameters

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

Returns object

objectstringrequired

connect_pending

tokenstringrequired
platformstring
flowstring
profile_idstring | null
stepstringrequired
multipleboolean
user_profileobject | null
Show 4 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
targetsarray of objectrequired
Show 8 item attributes
idstring
account_typestring
namestring | null
usernamestring | null
avatar_urlstring | null
already_connectedboolean
account_idstring | null
detailsobject
optionsarray of object
Show 4 item attributes
idstring
namestring | null
descriptionstring | null
privacystring | null
expires_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/snapchat/select-profile
curl "https://api.socialit.com/v1/connect/snapchat/select-profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/snapchat/select-profile

Try it with MCPAsk your agent to call select-snapchat-profile-connect-targets (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

tokenstring

Pending connection token (cpt_…)

1–128 characters

pending_tokenstring

Pending connection token (cpt_…)

1–128 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

target_idsarray of string

≤ 500 items

public_profile_idstring

≤ 100 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/snapchat/select-profile
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
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/bluesky/credentials

Try it with MCPAsk your agent to call connect-bluesky-credentials (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

identifierstringrequired

1–255 characters

app_passwordstring

1–500 characters

passwordstring

1–500 characters

auth_factor_tokenstring

≤ 100 characters

profile_idstring
redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

statestring

Ignored (Zernio compatibility)

≤ 200 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/bluesky/credentials
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
{
  "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: writeIdempotency-KeyZernio: POST /v1/connect/discord

Try it with MCPAsk your agent to call connect-discord-channels (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

guild_idstring

≤ 40 characters

channel_idstring

≤ 40 characters

channel_idsarray of string

≤ 25 items

profile_idstring
tokenstring

Pending connection token (cpt_…)

1–128 characters

redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

Returns object

objectstringrequired

connect_result

statusstringrequired

connectedpending_selection

platformstring
profile_idstring | null
accountsarray of objectrequired
Show 26 item attributes
objectstringrequired

account

idstringrequired
platformstringrequired
connect_flowstring
account_typestring

profilepageorganizationchannel

profile_idstring | null
group_idsarray of string
external_idstring
parent_external_idstring | null
usernamestring | null
namestring | null
display_namestring | null
avatar_urlstring | null
profile_urlstring | null
statusstringrequired

activeneeds_reconnect

is_activeboolean
needs_reconnectboolean
publishing_pausedboolean

Beyond the plan account allowance: publishing is paused

scopesarray of string
token_expires_atstring (date-time) | null
default_configobject
metadataobject
followers_countinteger | null
followers_updated_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
failedarray of object
Show 3 item attributes
idstring
codestring
messagestring
pendingobject | null
redirect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/discord
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
{
  "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/connect/links

Access: admin

Try it with MCPAsk your agent to call list-connect-links (toolset accounts)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_atexpires_atname

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring
statusstring

activeexpiredrevokedexhausted

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 16 item attributes
objectstringrequired

connect_link

idstringrequired
namestring | null
profile_idstring | null
urlstringrequired
platformsarray of string | null
brandingobject
Show 5 child attributes
namestring | null
logo_urlstring | null
primary_colorstring | null
accent_colorstring | null
background_colorstring | null
redirect_urlstring | null
statusstringrequired

activeexpiredrevokedexhausted

max_usesinteger | null
use_countinteger
last_used_atstring (date-time) | null
expires_atstring (date-time)
revoked_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/links
curl "https://api.socialit.com/v1/connect/links" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}
POST/connect/links

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

Access: adminIdempotency-Key

Try it with MCPAsk your agent to call create-connect-link (toolset accounts)Set up MCP

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

profile_idstringrequired
namestring | null

≤ 100 characters

platformsarray of string | null

≤ 40 items

brandingobject
Show 5 child attributes
namestring | null

≤ 60 characters

logo_urlstring | null

≤ 1000 characters

primary_colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

accent_colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

background_colorstring | null

Hex color #RRGGBB

pattern ^#[0-9A-Fa-f]{6}$

redirect_urlstring | null

Absolute http(s) URL or app scheme

≤ 2000 characters

expires_ininteger

300–2592000

expires_atstring (date-time)
max_usesinteger | null

1–10000

Returns object

objectstringrequired

connect_link

idstringrequired
namestring | null
profile_idstring | null
urlstringrequired
platformsarray of string | null
brandingobject
Show 5 child attributes
namestring | null
logo_urlstring | null
primary_colorstring | null
accent_colorstring | null
background_colorstring | null
redirect_urlstring | null
statusstringrequired

activeexpiredrevokedexhausted

max_usesinteger | null
use_countinteger
last_used_atstring (date-time) | null
expires_atstring (date-time)
revoked_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/connect/links
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
{
  "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/connect/links/{id}

Access: admin

Try it with MCPAsk your agent to call get-connect-link (toolset accounts)Set up MCP

Path parameters

idstringrequired

connectLink id (cl_…)

1–80 characters

Returns object

objectstringrequired

connect_link

idstringrequired
namestring | null
profile_idstring | null
urlstringrequired
platformsarray of string | null
brandingobject
Show 5 child attributes
namestring | null
logo_urlstring | null
primary_colorstring | null
accent_colorstring | null
background_colorstring | null
redirect_urlstring | null
statusstringrequired

activeexpiredrevokedexhausted

max_usesinteger | null
use_countinteger
last_used_atstring (date-time) | null
expires_atstring (date-time)
revoked_atstring (date-time) | null
created_atstring (date-time)
updated_atstring (date-time)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/connect/links/{id}
curl "https://api.socialit.com/v1/connect/links/cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "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"
}
DELETE/connect/links/{id}

Access: admin

Try it with MCPAsk your agent to call revoke-connect-link (toolset accounts)Set up MCP

Path parameters

idstringrequired

connectLink id (cl_…)

1–80 characters

Returns object

objectstringrequired

connect_link

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/connect/links/{id}
curl -X DELETE "https://api.socialit.com/v1/connect/links/cl_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "connect_link",
  "id": "string",
  "deleted": true
}