Skip to content
Relay Port

Instagram

Connect Instagram

Connect Instagram professional accounts with Meta's own sign-in, from the Dashboard or with a hosted connect link your customers open.

Relay Port publishes to Instagram professional accounts: Business and Creator accounts in a business portfolio. Personal accounts cannot publish through Instagram's API, so connecting one is refused with a message to switch the account to a professional one.

What the connection asks for

The sign-in asks Instagram for two permissions and nothing else:

  • instagram_basic, to read the account's profile and media.
  • instagram_content_publish, to publish posts.

The person connecting signs in with Instagram or Facebook, chooses the business portfolio and then the professional accounts to connect. Relay Port keeps the access tokens encrypted and refreshes them before they expire.

From the Dashboard

Open the accounts page in the Dashboard and choose to connect Instagram. The accounts join the brand you pick.

When your customers own the accounts, create a link with POST /connect-links and send them its url. They sign in on the hosted connect page, without a Dashboard login, and the accounts join the brand the link names.

  • Send redirectUri, and state if you want it back, to end on your own page with status, accountIds, brandId, state and error in the query. Without one, the link ends on the connect page's own result screen.
  • Set purpose to reconnect with an accountId to let a customer reconnect an account that needs it. If they sign in with a different account, the link ends with account_mismatch and stays usable.
  • A link stops working when it expires, when you revoke it with DELETE /connect-links/{id}, or when its creator loses the right to connect accounts. The url carries the link token only once and links cannot be listed, so keep the id.

An API key cannot start a live sign-in itself: POST /accounts/connect with a live key is refused, so connect real accounts with a link. Test keys use it for sandbox accounts.

After connecting

  • GET /accounts lists the accounts with their status.
  • When Instagram needs an action from the account owner, or the access ends, the account becomes action_required or reconnect_required, and the account.action_required or account.reconnect_required event fires. Send a reconnect link, then POST /accounts/{id}/check reads the profile again.
  • GET /accounts/{id}/capabilities says what the account can do now, and why not where it cannot.
  • DELETE /accounts/{id} disconnects the account and deletes its stored credentials. To also remove the app's access on Meta's side, remove it in Meta Business Suite under Settings, Integrations, Connected apps.