API reference
List connected social accounts with filters, search, sorting and offset pagination.
https://api.betterpost.dev/v1/connect/integrationsDisconnected accounts are not listed.
| Name | Type | Default | Description |
|---|---|---|---|
platform | string | twitter, linkedin, instagram or facebook. | |
profileId | string | Accounts in this profile. The literal null returns accounts outside any profile. | |
q | string | Case-insensitive match on username, displayName or platformUserId, or an exact account id. | |
limit | integer | 20 | 1 to 100. |
offset | integer | 0 | Accounts to skip. |
sortBy | string | createdAt | createdAt or name (username, then display name). |
sort | string | desc | asc or desc. |
curl -s "https://api.betterpost.dev/v1/connect/integrations?platform=twitter&profileId=null" \
-H "x-access-key: $BETTERPOST_API_KEY"200 OK
{
"success": true,
"total": 1,
"integrations": [
{
"id": "acc_2x9c4v7b1n8m3k5j0h6g2f4d",
"platform": "twitter",
"platformUserId": "sbx_4829105736",
"username": "@demo_brand",
"displayName": "Demo Brand",
"imageUrl": "https://api.dicebear.com/9.x/initials/svg?seed=%40demo_brand",
"profileId": null,
"authStatus": "active",
"sandbox": true,
"createdAt": "2026-10-21T14:05:40.031Z"
}
]
}| Field | Description |
|---|---|
id | Use as accountId when posting. |
platformUserId | The account's id on the network (sbx_... in the sandbox). |
username, displayName, imageUrl | Account details shown to users. |
profileId | The profile it belongs to, or null. |
authStatus | active, or reconnect_required when it must be reconnected. |
sandbox | Always true for now. |
| Status | Code | When |
|---|---|---|
200 | Success. | |
400 | invalid_platform | Unknown platform. |
400 | validation_error | limit, offset, sortBy or sort is invalid. |
401 | unauthorized | Missing or unknown API key. |
403 | platform_not_available | A platform BetterPost does not support yet. |
429 | rate_limited | More than 120 requests per minute. |