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

Disconnect a Facebook account

Disconnects a previously connected Facebook Pages account from your listingsAPI account.

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

Parameters

Body

NameTypeRequiredDescription
connectedAccountIdstringrequiredUUID of the connected Facebook account to disconnect.
locationIdsarray of stringsoptionalBase64-encoded location IDs to disconnect from the account. Omit to disconnect every location under the account.

Sample request

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

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

Responses

200Account disconnected successfully.
{
  "data": {
    "fbBulkDisconnect": {
      "success": true
    }
  }
}
400Bad request — missing connectedAccountId, or unknown account.
401Unauthenticated — missing or invalid API key.

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

By default the entire account is disconnected. Pass locationIds to disconnect the account from only a subset of locations while leaving the rest connected — useful when a single Facebook account spans multiple clients and only one is leaving.

Use case — offboarding a departing client. When a client cancels, disconnect their Facebook account so listingsAPI stops managing their pages and no further posts or replies are pushed on their behalf. Supply the client's connectedAccountId (from GET /connected-accounts) with no locationIds 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; to detach a single listing without removing the whole account, use the disconnect-listing endpoint.

curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \
  -H "Authorization: API $LISTINGSAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "connectedAccountId": "<connectedAccountId>",
    "locationIds": "<locationIds>"
  }'
Run in playground