/api/v4/locations/oauth-disconnectDisconnect a location from Apple Business Connect
Removes one location's connection to the owner's Apple Business account. The location stays on Apple Maps and is published through the ListingsAPI account.
Parameters
Body
| Name | Type | Required | Description |
|---|---|---|---|
| input | object | required | Wrapper object. The entire request body must be nested under `input`. |
| input.locationId | string | required | Base64-encoded Relay ID of the one location to disconnect. |
| input.site | string | required | Set to `APPLE`. |
Sample request
Ready-to-paste body. Replace placeholder IDs and values with yours.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "APPLE" }}Responses
200Connection removed. Response key `disconnectConnectedAccountsLocations`.
{ "data": { "disconnectConnectedAccountsLocations": { "clientMutationId": null, "success": true, "errors": null } }}401Unauthenticated, missing or invalid API key.
403The key is valid but not permitted to disconnect this location (`SY90003`).
Use this when a client leaves and takes their Apple Business account with them. The location stays in your account and stays on Apple Maps: later updates are published through the ListingsAPI Apple Business Connect account, and Apple verifies the submission before it publishes. Other publisher connections on the location are not affected.
A location with no active Apple connection returns SY10057, so success: true means a connection was removed. The call handles one location; loop to disconnect several.
To publish through the owner's account again, send them a new link from Connect a location to Apple Business Connect.
This page documents the site: "APPLE" case of Disconnect one location from a publisher.
This endpoint changes a live connection. The sample request and response above are examples.
curl -X POST 'https://listingsapi.com/api/v4/locations/oauth-disconnect' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "site": "APPLE" } }'