Connecting an Instagram Account
Connect an Instagram Business or Creator account to your workspace to publish and manage content.
Connect an Instagram account to your workspace from Settings → Integrations → Connect Instagram. The connect flow takes you through Instagram's OAuth dialog and brings the connected account back into the workspace.
What this connects
You grant the app permission to read insights and publish to a single Instagram Business or Creator account. Personal Instagram accounts can't be connected — the Instagram API doesn't allow Personal accounts to publish or expose insights. Convert your account in the Instagram mobile app under Settings → Account type and tools → Switch to professional account before connecting.
What we store
- An encrypted access token for the connected Instagram account (envelope-encrypted at rest; the plaintext token never leaves the server boundary).
- The Instagram user ID and username so the workspace can list connections.
- The scopes you granted and the timestamp of consent.
We never store your Instagram password. Tokens are scoped to the single Instagram account you connected — disconnecting revokes access for that account only.
How to revoke
You can disconnect from either side:
- In the product — Settings → Integrations → click Disconnect on the Instagram row. The access token is revoked at the provider and the row is removed immediately.
- At Instagram — instagram.com/accounts/manage_access → find the app → Remove. This forces revoke at the source if anything went wrong with step 1.
Troubleshooting
| Message | What it means |
|---|---|
"Connecting Instagram requires a Business or Creator account." (instagram_no_business_account) | Your Instagram account is Personal. Switch to Business or Creator in the Instagram app, then retry. |
"Facebook didn't grant the permissions we need to publish." (scope_rejected) | You unticked one or more permissions on the Instagram dialog. Retry and leave all boxes checked. |
"The connection link expired." (state_expired) | The connect link is good for 10 minutes. Click Connect Instagram again to start fresh. |
"Network error reaching Facebook." (network_error) | A transient network failure interrupted the flow. Retry in a moment. |