About the Accounts API

The Accounts API lets you retrieve a site's connected social channel accounts and check whether those connections are still valid. An account represents a channel the site owner has connected in the dashboard, such as an Instagram business account or a Facebook page. You need an account's id when you create or publish items to that channel.

With the Accounts API, you can:

  • List connected accounts for one or more channels.
  • Check whether a channel's access token is still valid.
  • Update account settings, such as the default account for a channel.

Before you begin

It's important to note the following points before starting to code:

  • A site owner connects social channels in the site's dashboard. The public API reads connected accounts but does not connect or disconnect channels programmatically. See Connecting to your social media accounts.
  • If Get Long Lived Token Status shows that a token is invalid, the site owner must reconnect the channel in the dashboard before you can publish to it.

Use cases

Terminology

  • Account: A social channel connection on a site, such as an Instagram business account or a Facebook page. Items are published to an account.
  • Channel: The social network an account belongs to, such as Instagram, Facebook, or TikTok.

See also

Did this help?