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.
With a hosted connect link
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, andstateif you want it back, to end on your own page withstatus,accountIds,brandId,stateanderrorin the query. Without one, the link ends on the connect page's own result screen. - Set
purposetoreconnectwith anaccountIdto let a customer reconnect an account that needs it. If they sign in with a different account, the link ends withaccount_mismatchand 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. Theurlcarries the link token only once and links cannot be listed, so keep theid.
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 /accountslists the accounts with theirstatus.- When Instagram needs an action from the account owner, or the access ends, the account becomes
action_requiredorreconnect_required, and theaccount.action_requiredoraccount.reconnect_requiredevent fires. Send a reconnect link, thenPOST /accounts/{id}/checkreads the profile again. GET /accounts/{id}/capabilitiessays 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.