POST/api/v4/connected-accounts/disconnect-google

Disconnect a Google account

Disconnects a connected Google Business Profile account (or specific locations under it) from your listingsAPI account.

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

Parameters

Body

NameTypeRequiredDescription
connectedAccountIdstringrequiredUUID of the connected Google account to disconnect.
locationIdsarray of stringsoptionalBase64-encoded listingsAPI location IDs to disconnect from this account. Omit to disconnect the entire account.

Responses

200Account (or the listed locations) disconnected. `disconnected` is the number of location links removed.
{
  "data": {
    "gmbBulkDisconnect": {
      "disconnected": 20
    }
  }
}
401Unauthenticated — missing or invalid API key.

Severs the link between a connected Google Business Profile account and your listingsAPI account. Once disconnected, listings that were synced through that account stop receiving updates from listingsAPI. The disconnected count reports how many location links were removed.

Pass connectedAccountId on its own to disconnect the entire Google account and every location linked through it. To disconnect only part of an account, include locationIds (base64-encoded) — listingsAPI then unlinks just those locations and leaves the rest of the account connected.

Use case — full offboarding when a client leaves. Send only connectedAccountId to tear down the whole connection in one call. This is the clean way to revoke listingsAPI's access after a customer churns or transfers ownership of their Google account.

Use case — surgical unlink during a migration. When you are moving a handful of storefronts to a different Google account but keeping the rest where they are, pass those specific locationIds so the bulk disconnect only touches them. For Facebook accounts, use the disconnect-facebook endpoint, which takes the same request shape.

This endpoint mutates a live connection and revokes listingsAPI's access to Google. The request shape and sample response above are documented from the API specification; the call is not executed against production data.

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