REST APIGET

Explained clearly - Social media user profile API

Retrieve every social media account connected to your AdaptlyPost workspace, with its platform, ID and connection status.

GEThttps://post.adaptlypost.com/post/api/v1/social-accounts

Returns a list of all social media accounts connected to your workspace. Use the returned connection IDs when creating posts.

API Key (Bearer token)

Permission:accounts.readRoles and permissions

Usage

Use the id values from this response as connection IDs when creating posts. Each account includes a displayName, username, and avatarUrl. Facebook page accounts also include a pageId (the Facebook Page ID), since pages have no username. For Facebook, pageIds accepts either the account id or the pageId, and post responses always return the Facebook pageId. Each account also carries a status: active, or unauthorized when the platform rejected its token. Posts to an unauthorized account are refused with a 400 until it is reconnected in the dashboard, and unauthorizedReason carries the platform's own message.

Re-check an account

POSThttps://post.adaptlypost.com/post/api/v1/social-accounts/:id/check

Pages are checked with Facebook automatically twice a day. To check one now, call this endpoint with the account id or the Facebook pageId. A rejected token marks the page unauthorized and fires account.unauthorized; a working token clears an earlier mark. The response carries the fresh status.

API Key (Bearer token)

Permission:accounts.manageRoles and permissions

Only an Admin key holds accounts.manage. Connecting, disconnecting and re-checking accounts, choosing pages and boards, Pinterest preferences and connect links are Admin only.

List All Integrations

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts \
  --header 'Authorization: Bearer <api-key>'

Check a Facebook page now

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-accounts/<account-id>/check \
  --header 'Authorization: Bearer <api-key>'

200

{
  "accounts": [
    {
      "id": "conn_abc123",
      "platform": "TWITTER",
      "displayName": "Your Handle",
      "username": "@yourhandle",
      "avatarUrl": "https://pbs.twimg.com/profile_images/...",
      "status": "active"
    },
    {
      "id": "conn_def456",
      "platform": "LINKEDIN",
      "displayName": "Your Company",
      "username": "",
      "avatarUrl": "https://media.licdn.com/...",
      "status": "active"
    },
    {
      "id": "conn_ghi789",
      "platform": "INSTAGRAM",
      "displayName": "Your Profile",
      "username": "yourprofile",
      "avatarUrl": "https://scontent.cdninstagram.com/...",
      "status": "active"
    },
    {
      "id": "conn_jkl012",
      "platform": "FACEBOOK",
      "displayName": "Your Page",
      "username": "",
      "avatarUrl": "",
      "status": "unauthorized",
      "unauthorizedReason": "This Page access token belongs to a Page that is not accessible.",
      "pageId": "123456789012345"
    }
  ]
}