Listings APIListings API
Get API keySign in
POST/api/v4/connected-accounts/disconnect-facebook

Disconnect a Facebook account

Disconnects a previously connected Facebook Pages account from your Listings API account.

Requires an API key. See Authentication for header format and key rotation.

Parameters

Body

NameTypeRequiredDescription
inputobjectrequiredWrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstringrequiredUUID of the connected Facebook account to disconnect. The whole account is disconnected.

Sample request

Ready-to-paste body. Replace placeholder IDs and values with yours.

{
  "input": {
    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"
  }
}

Responses

200Request accepted. `success: true` confirms the disconnect was processed.
{
  "data": {
    "fbBulkDisconnect": {
      "success": true
    }
  }
}
400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (GraphQL: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.

Severs the link between a connected Facebook Pages account and your Listings API account. Once disconnected, listings synced through that account stop receiving updates from Listings API and Facebook interactions stop appearing in the dashboard.

Request shape. The body must be wrapped in an input object whose only field is connectedAccountId. This is an all-or-nothing operation, the entire connected account is disconnected. There is no locationIds field; it is rejected by the schema. To detach a single location's listing while leaving the account connected, use the disconnect-listing endpoint instead.

Use case: offboarding a departing client. When a client cancels, disconnect their Facebook account so Listings API stops managing their pages and no further posts or replies are pushed on their behalf. Supply the client's connectedAccountId (from GET /connected-accounts) to fully detach the account.

Use case: reauthorizing a broken connection. If a Facebook connection has credential errors that a re-auth cannot clear, disconnect it here and issue a fresh link with the connect-facebook endpoint. success: true confirms the disconnect. For Google, use the disconnect-google endpoint. Note that a success: true response is returned even for an unknown connectedAccountId, so treat success as "the request was processed," not proof that a live connection was removed, confirm the account's state with GET /connected-accounts if you need certainty.

curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \
  -H "Authorization: API $LISTINGSAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "input": {
      "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"
    }
  }'
Run in playground