Social Accounts

Disconnect (or permanently delete) a social account

Disconnect a social account. By default this is a soft disconnect: the stored credentials are wiped, the account stops counting toward your plan's account limit, and it stays in GET /v0/social-accounts with status: "disconnected" and disconnectedReason: "TOKEN_REVOKED" until it is reconnected from the dashboard. All of its posts, analytics, and history are kept; scheduled posts that come due while it is disconnected fail with a "reconnect" error instead of publishing. Pass permanent=true to delete the account instead — this permanently deletes every post (scheduled, draft, and published history) of the account and cannot be undone.

delete/v0/social-accounts/{id}

Request

  • Base URL: https://api.schedulin.app
  • URL: https://api.schedulin.app/v0/social-accounts/{id}
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://api.schedulin.app/oauth/authorize, token URL https://api.schedulin.app/oauth/token, scopes: social-accounts:write)

Path parameters

idstring required

Query parameters

permanentboolean

Delete the account instead of disconnecting it. PERMANENTLY deletes every post (scheduled, draft, and published history) of the account. Default false.

Request body

object required

Response

OK

successboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.