Accounts
2 endpoints: list connected accounts, retrieve an account.
- List connected accounts:
GET /v1/accounts - Retrieve an account:
GET /v1/accounts/{account_id}
List connected accounts
GET /v1/accounts
Lists the social accounts connected in the Projects this key can reach, oldest first.
Permission: accounts:read
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Items per page, 1 to 100. (1 to 100, default 25) |
cursor | string | No | The next_cursor of the previous page. (up to 512 characters) |
project_id | string | No | (up to 128 characters) |
network | youtube, tiktok, instagram, facebook, threads, bluesky, mastodon, pinterest, telegram, twitch, x, discord | No |
Response
| Field | Type | Required | Description |
|---|---|---|---|
object | "list" | Yes | |
data | array of object | Yes | |
data[].object | "account" | Yes | |
data[].id | string | Yes | (up to 128 characters) |
data[].project_id | string or null | Yes | |
data[].network | youtube, tiktok, instagram, facebook, threads, bluesky, mastodon, pinterest, telegram, twitch, x, discord | Yes | |
data[].name | string | Yes | |
data[].handle | string or null | Yes | |
data[].avatar_url | string or null | Yes | |
data[].followers | integer or null | Yes | |
data[].status | active, reconnect_required, error | Yes | |
data[].connected_at | string | Yes | ISO 8601 date and time, UTC. |
has_more | boolean | Yes | |
next_cursor | string or null | Yes |
curl https://api.nowscale.com/v1/accounts \
-H "Authorization: Bearer $NOWSCALE_API_KEY"Retrieve an account
GET /v1/accounts/{account_id}
Returns one connected account.
Permission: accounts:read
Path parameters
| Name | Description |
|---|---|
account_id | The account's id. |
Response
| Field | Type | Required | Description |
|---|---|---|---|
object | "account" | Yes | |
id | string | Yes | (up to 128 characters) |
project_id | string or null | Yes | |
network | youtube, tiktok, instagram, facebook, threads, bluesky, mastodon, pinterest, telegram, twitch, x, discord | Yes | |
name | string | Yes | |
handle | string or null | Yes | |
avatar_url | string or null | Yes | |
followers | integer or null | Yes | |
status | active, reconnect_required, error | Yes | |
connected_at | string | Yes | ISO 8601 date and time, UTC. |
curl https://api.nowscale.com/v1/accounts/ACCOUNT_ID \
-H "Authorization: Bearer $NOWSCALE_API_KEY"