Accounts

Re-check an account with its platform now

Probes the platform with the stored token and returns the resulting status. Facebook pages only: a rejected token marks the page unauthorized (and fires account.unauthorized), a working token clears an earlier unauthorized mark. Pages are also checked automatically twice a day. Accepts the account id or the Facebook pageId.. Requires the accounts.manage permission.

post/social-accounts/{id}/check

Request

  • Base URL: https://post.adaptlypost.com/post/api/v1
  • URL: https://post.adaptlypost.com/post/api/v1/social-accounts/{id}/check
  • Auth: HTTP bearer

Path parameters

idstring required

The account id from /social-accounts, or the Facebook pageId

Headers

X-Workspace-Idstring

The workspace to act in, for OAuth sign-ins that reach several workspaces. Take the id from GET /workspaces. Without it the call lands in the default workspace. A workspace the caller cannot reach answers 403 with code: workspace_access_denied. An API key belongs to one workspace: send its own id or leave the header out

Response

Fresh account status

idstring
platform'FACEBOOK' | 'INSTAGRAM' | 'THREADS' | 'TIKTOK' | 'TWITTER' | 'BLUESKY' | 'LINKEDIN' | 'PINTEREST' | 'YOUTUBE' | 'MASTODON' | 'TELEGRAM' | 'GOOGLE_BUSINESS' | 'TUMBLR'
displayNamestring
pageIdstring
status'active' | 'unauthorized'

unauthorized means the platform rejected the stored token: posts to this account are refused with a 400 until it is reconnected in the dashboard

unauthorizedReasonstring

The platform's own rejection message, when status is unauthorized

checkedAtstring date-time

Changes

No recorded changes to this operation across all 2 revisions of this API.