Disconnect a Social Account

Remove a connected social account from your workspace

Published

DELETE
/v1/social/accounts/2291
curl -X DELETE "https://api.orshot.com/v1/social/accounts/2291" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>"

Disconnect a social account. Orshot revokes its own access at the publishing provider first, then removes the account from the workspace and takes it off the owner's bill from the next cycle. Posts scheduled for the account are no longer sent.

The person who connected the account can connect it again later with a new connect link or from the dashboard.

Endpoint#

DELETE /social/accounts/:id#

Endpoint
https://api.orshot.com/v1/social/accounts/2291

Request Example#

JavaScript
await fetch("https://api.orshot.com/v1/social/accounts/2291", {
  method: "DELETE",
  headers: {
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Response Example#

JSON
{
  "data": {
    "success": true,
    "disconnected": true,
    "message": "Disconnected instagram account",
    "account": {
      "id": 2291,
      "platform": "instagram",
      "username": "acme_athens",
      "name": "Acme Athens",
      "external_id": "office_142"
    }
  }
}

An account that was already disconnected answers 200 with "disconnected": false.

Error Responses#

CodecodeDescription
403insufficient_roleThe OAuth token's person is not an owner or admin of the workspace
404No account with this id in the workspace
500disconnect_incompleteAccess was revoked at the provider but the account record could not be updated yet. It is repaired automatically within the hour
503provider_unavailableThe publishing provider could not be reached. Nothing changed; retry
Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 40+ integrations
  • White-label embed for your own app
  • 100 free credits a month, no credit card required