Skip to content

Disconnect Social Account API

The Disconnect Social Account API removes a connected social account from a project. Use it when an account should no longer be available for account operations, passing the Integration ID obtained from the List endpoint as the id path parameter.

Purpose and when to remove a connected account

Use the disconnect operation when a connected social account should be removed from a project. The request identifies a single integration through its Integration ID, so the workflow starts by listing connected social accounts and selecting the entry to remove. If the account should instead be reassigned to another profile, use the related move operation rather than disconnecting and reconnecting it.

Endpoint contract

The endpoint contract is DELETE {{API_BASE_URL}}/v1/connect/integrations/{id}. The method is DELETE and the path is /v1/connect/integrations/{id}, with the origin supplied by {{API_BASE_URL}}. The request uses the x-access-key header shown in the Disconnect request example. Do not substitute a different method or path when calling this operation.

Path parameters field map

The only path parameter is id, a string containing the Integration ID from the List endpoint. This value is required to identify which connected social account to disconnect. Before sending the request, confirm that the id exactly matches an integration returned by the List endpoint; a mismatched or stale value leads to the Integration not found failure described below.

Worked example

First, call the List endpoint for connected social accounts and find the Integration ID for the account to remove. Then replace the placeholder in the Disconnect request example with that id and send the DELETE request with your access key in the x-access-key header. After the call, inspect the status code and response body: a 200 response should contain success set to true and a message confirming the disconnect, while a 404 response indicates the integration could not be found.

Response contract

On success, the response contains two fields. The success field is a boolean set to true, and the message field is a string carrying the confirmation text, as shown in the Disconnect success response example. Treat the operation as complete only when the status code is 200 and success is true; do not rely on the message text alone to decide whether the disconnect succeeded.

Status codes and failure matrix

A 200 status means Account disconnected and the response body should confirm success. A 404 status means Integration not found, which usually means the id does not match a current integration, was copied incorrectly, or refers to an account that has already been removed. When you receive a 404, re-list connected social accounts, verify the Integration ID, and retry only with a valid current id.

Path parameters
ParameterTypeDescription
idstringIntegration ID from the List endpoint

id is a required string path parameter.

Status codes
CodeMeaning
200Account disconnected
404Integration not found

Status meanings preserved exactly from the source contract.

Frequently asked questions

How do I disconnect a connected social account?

Send a DELETE request to {{API_BASE_URL}}/v1/connect/integrations/{id}, where id is the Integration ID for the connected social account you want to remove. A 200 response with success set to true confirms the account was disconnected.

Where do I get the id value for the disconnect request?

Obtain the Integration ID from the List endpoint for connected social accounts, then use that exact string value as the id path parameter in the DELETE request.

What does a 404 response mean when disconnecting an account?

A 404 response means Integration not found. Check that the id matches an integration returned by the List endpoint and that it has not already been removed.

Disconnect request example
curl -X DELETE "{{API_BASE_URL}}/v1/connect/integrations/abc123" \
  -H "x-access-key: YOUR_API_KEY"
Disconnect success response example
{
	"success": true,
	"message": "twitter disconnected."
}
Contract example 1
DELETE {{API_BASE_URL}}/v1/connect/integrations/{id}