Identify, disconnect or reconnect a connected instagram account
An Admin reviews a connected Instagram account's identity, disconnects it, or reconnects it after it stops working, without losing conversation history.
When this happens: Admin opens a connection's detail in Channel Administration.
Step by step
- 1
Open
/admin/channels/instagram/{id}and reviews@handle, display name, auth path and linked Page (if any). - 2
Click Disconnect and confirms.
Calls Instagram's revocation endpoint (best-effort) and sets
Disconnected. Retains all conversations and messages on this connection, visible as read-only until reconnected.
Other paths
Reconnect
Click Reconnect on a Disconnected or RequiresReauth connection. Repeats UC-17.1's flow for the same auth path against the existing ChannelConnection.Id — settings and history are preserved.
If something goes wrong
Provider revocation call fails
At step 3 Instagram's revocation call fails. Local disconnect still completes; the provider-side grant may remain until the Owner also removes the app from Instagram's own settings.
Good to know
- Disconnecting never deletes conversation or message history.
- Reconnecting reuses the existing connection identity.