About the Accounts API

The Accounts API lets you connect and disconnect a site's social channels, retrieve its connected accounts, and check whether those connections are still valid. An account represents a channel the site owner has connected, 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:

• Get a URL a site owner opens to connect a channel.
• 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.
• Disconnect a channel.

Connecting a channel

To connect a channel without a browser popup, call Get Connect Url to retrieve the channel's OAuth authorization URL, surface it to the site owner, and have them authorize the channel in their browser. The channel's OAuth redirect completes the connection server-side, after which the channel becomes connected. Poll Get Long Lived Token Status until the status is VALID to confirm. To disconnect a channel, call Disconnect.

Before you begin

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

• Connecting a channel always requires the site owner to authorize it in their browser, whether they start from the dashboard or from a connect URL. 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

• Connect a social channel.
• Create and publish a post.

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

• About the Items API.
• Publisher API sample flows.