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. 1

    Open /admin/channels/instagram/{id} and reviews @handle, display name, auth path and linked Page (if any).

  2. 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.