Reference

Accounts

List the connected LinkedIn, Instagram, WhatsApp, Telegram and Facebook accounts in the workspace.

A connected account (a sender) is one identity on one channel. The API reads accounts; connecting, reconnecting and changing limits happen in the app, where the account owner confirms the connect statements. Removed accounts are not listed. See Accounts for what each status means.

List accounts

GET/api/v1/accountsScope senders:read

Connected accounts on every channel, newest first. status is one of connecting, active, reconnect_required, restricted, paused or disconnected; statusReason says why.

Parameters

NameInTypeDescription
cursorquerystringOpaque cursor from the previous page's nextCursor.
limitqueryintegerPage size. 1 to 100. Default 50.

Example request

curl -s "https://app.graphkit.com/api/v1/accounts" \
  -H "Authorization: Bearer $GRAPHKIT_API_KEY"

Response 200

FieldTypeDescription
dataarray of objectThe page of results, newest first.
data[].idstring (uuid)UUID.
data[].channelstringThe channel. One of linkedin, instagram, whatsapp, telegram, facebook.
data[].displayNamestringName shown on the account.
data[].handlestring or nullPublic handle on the channel (LinkedIn slug, @username or phone).
data[].profileUrlstring or nullProfile URL on the channel.
data[].avatarUrlstring or null
data[].statusstringCurrent status.
data[].statusReasonstring or nullWhy the account has this status, when there is a reason.
data[].connectedAtstring (date-time) or nullWhen the account first connected.
data[].lastSyncedAtstring (date-time) or nullLast successful sync with the network.
data[].isDemobooleanTrue for demo data in a demo workspace.
data[].createdAtstring (date-time)When it was created (RFC 3339, UTC).
nextCursorstring or nullPass back as cursor for the next page; null on the last page.
{
  "data": [
    {
      "id": "0193a5b2-7c1e-7a10-9f2a-2b3c4d5e6f99",
      "channel": "linkedin",
      "displayName": "Sam Lee",
      "handle": "jane-doe",
      "profileUrl": "https://www.linkedin.com/in/jane-doe",
      "avatarUrl": null,
      "status": "active",
      "statusReason": null,
      "connectedAt": "2026-11-15T10:04:05Z",
      "lastSyncedAt": null,
      "isDemo": false,
      "createdAt": "2026-11-15T10:04:05Z"
    }
  ],
  "nextCursor": null
}

Errors

StatusCode and meaning
401invalid_api_key: the key is missing, unknown or revoked.
403insufficient_scope: the key lacks the scope this endpoint needs.
429rate_limited: more than 300 requests in a minute; wait for Retry-After.

Get an account

GET/api/v1/accounts/{id}Scope senders:read

One connected account by id.

Parameters

NameInTypeDescription
idpathstring (uuid)The resource id.

Example request

curl -s "https://app.graphkit.com/api/v1/accounts/0193a5b2-7c1e-7a10-9f2a-2b3c4d5e6f99" \
  -H "Authorization: Bearer $GRAPHKIT_API_KEY"

Response 200

FieldTypeDescription
idstring (uuid)UUID.
channelstringThe channel. One of linkedin, instagram, whatsapp, telegram, facebook.
displayNamestringName shown on the account.
handlestring or nullPublic handle on the channel (LinkedIn slug, @username or phone).
profileUrlstring or nullProfile URL on the channel.
avatarUrlstring or null
statusstringCurrent status.
statusReasonstring or nullWhy the account has this status, when there is a reason.
connectedAtstring (date-time) or nullWhen the account first connected.
lastSyncedAtstring (date-time) or nullLast successful sync with the network.
isDemobooleanTrue for demo data in a demo workspace.
createdAtstring (date-time)When it was created (RFC 3339, UTC).
{
  "id": "0193a5b2-7c1e-7a10-9f2a-2b3c4d5e6f99",
  "channel": "linkedin",
  "displayName": "Sam Lee",
  "handle": "jane-doe",
  "profileUrl": "https://www.linkedin.com/in/jane-doe",
  "avatarUrl": null,
  "status": "active",
  "statusReason": null,
  "connectedAt": "2026-11-15T10:04:05Z",
  "lastSyncedAt": null,
  "isDemo": false,
  "createdAt": "2026-11-15T10:04:05Z"
}

Errors

StatusCode and meaning
401invalid_api_key: the key is missing, unknown or revoked.
403insufficient_scope: the key lacks the scope this endpoint needs.
404not_found: no such resource in this key's workspace.
429rate_limited: more than 300 requests in a minute; wait for Retry-After.

On this page