Disconnect or revoke social account

A user disconnects a personal social account, or an Admin revokes a brand account. The CRM revokes tokens with the provider where possible, stops polling, and retains historical mentions and engagements for audit.

When this happens: You click Disconnect in Settings — Social Integration, or Admin clicks Revoke on a brand account.

Step by step

  1. 1

    Click Disconnect.

    Confirmation: Disconnecting will stop listening, scheduled posts on this account will fail, and existing mentions/activities will be retained for audit. Continue?.

  2. 2

    Confirm.

    Calls the provider's revoke endpoint with the refresh token (best-effort — provider failure does not block local disconnect). Sets , nulls AccessToken / RefreshToken / TokenExpiresAt, audit-logs SocialConnectionRevoked. Disables but does not delete SocialListeningRules that depended only on this connection — they are marked Inactive — connection revoked for the user to fix.

Other paths

Admin forced revoke

From Admin — Integrations — Social, revokes another your connection. The owning user receives a UC-10.1 notification: Your <provider> connection was disconnected by an administrator

If something goes wrong

Provider revoke endpoint fails

Provider returns 5xx. The local disconnect still completes (tokens scrubbed). A background job retries the provider revoke up to 3 times so the provider-side grant is also cleaned up.

Good to know

  • Historical mentions, posts, and engagement activities are preserved indefinitely (subject to FR-11 retention) so reports and audit logs remain coherent.
  • A you can only disconnect their own personal connections; brand-account revocation requires EasyCrm.SocialCrm.ManageBrandAccounts.