Listings APIListings API
Get API keySign in
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 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 Google 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": {
    "gmbBulkDisconnect": {
      "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 Google Business Profile account and your Listings API account. Once disconnected, listings that were synced through that account stop receiving updates from Listings API.

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 Google account and every location linked through it are disconnected. There is no locationIds field; it is rejected by the schema. To unlink a single location's listing while keeping the account connected, use the disconnect-listing endpoint.

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

Use case: offboarding a broken connection. If a Google connection has credential errors a re-auth cannot clear, disconnect it here and issue a fresh link with the connect-google endpoint. For Facebook accounts, use the disconnect-facebook endpoint, which takes the same request shape. 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.

This endpoint mutates a live connection and revokes Listings API'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 '{
    "input": {
      "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"
    }
  }'
Run in playground