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:readConnected accounts on every channel, newest first. status is one of connecting, active, reconnect_required, restricted, paused or disconnected; statusReason says why.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
cursor | query | string | Opaque cursor from the previous page's nextCursor. |
limit | query | integer | Page 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
| Field | Type | Description |
|---|---|---|
data | array of object | The page of results, newest first. |
data[].id | string (uuid) | UUID. |
data[].channel | string | The channel. One of linkedin, instagram, whatsapp, telegram, facebook. |
data[].displayName | string | Name shown on the account. |
data[].handle | string or null | Public handle on the channel (LinkedIn slug, @username or phone). |
data[].profileUrl | string or null | Profile URL on the channel. |
data[].avatarUrl | string or null | |
data[].status | string | Current status. |
data[].statusReason | string or null | Why the account has this status, when there is a reason. |
data[].connectedAt | string (date-time) or null | When the account first connected. |
data[].lastSyncedAt | string (date-time) or null | Last successful sync with the network. |
data[].isDemo | boolean | True for demo data in a demo workspace. |
data[].createdAt | string (date-time) | When it was created (RFC 3339, UTC). |
nextCursor | string or null | Pass 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
| Status | Code and meaning |
|---|---|
| 401 | invalid_api_key: the key is missing, unknown or revoked. |
| 403 | insufficient_scope: the key lacks the scope this endpoint needs. |
| 429 | rate_limited: more than 300 requests in a minute; wait for Retry-After. |
Get an account
GET
/api/v1/accounts/{id}Scope senders:readOne connected account by id.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id | path | string (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
| Field | Type | Description |
|---|---|---|
id | string (uuid) | UUID. |
channel | string | The channel. One of linkedin, instagram, whatsapp, telegram, facebook. |
displayName | string | Name shown on the account. |
handle | string or null | Public handle on the channel (LinkedIn slug, @username or phone). |
profileUrl | string or null | Profile URL on the channel. |
avatarUrl | string or null | |
status | string | Current status. |
statusReason | string or null | Why the account has this status, when there is a reason. |
connectedAt | string (date-time) or null | When the account first connected. |
lastSyncedAt | string (date-time) or null | Last successful sync with the network. |
isDemo | boolean | True for demo data in a demo workspace. |
createdAt | string (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
| Status | Code and meaning |
|---|---|
| 401 | invalid_api_key: the key is missing, unknown or revoked. |
| 403 | insufficient_scope: the key lacks the scope this endpoint needs. |
| 404 | not_found: no such resource in this key's workspace. |
| 429 | rate_limited: more than 300 requests in a minute; wait for Retry-After. |