Disconnect Ad Platform Connection
DELETE/api/advertising/connections/:integrationInstance
Disconnects an ad platform connection. Every ad account on it is deselected, set to disabled and has its automation mode switched to off, and automatic syncing is turned off for the connection. Historical performance, change history and cost entries are kept. Returns the number of accounts disabled.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.manage permission. Token scope: advertising:write (personal access and OAuth tokens).
Returns 404 when the connection does not exist or has no ad accounts.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.