Social accounts
Find connected accounts and their ids, filtered by platform, profile or a search string.
curl -s "https://api.betterpost.dev/v1/connect/integrations?platform=twitter&limit=20" \
-H "x-access-key: $BETTERPOST_API_KEY"{
"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"
}
]
}Filters (all optional):
platform: one of the four platforms.profileId: accounts in that profile, or the literal null for accounts outside any profile.q: case-insensitive match on username, display name or platform user id, or an exact integration id.limit (1 to 100, default 20) and offset (default 0).sortBy (createdAt or name, default createdAt) and sort (asc or desc, default desc).authStatus is active or reconnect_required. Disconnected accounts are not listed. Fetch one account with
GET /v1/connect/integrations/{id}.
Reference: GET /v1/connect/integrations.