Merge Ad Accounts
POST/api/advertising/accounts/:adAccount/merge
Folds an older copy of the same platform account (from_ad_account_id, usually from a connection that was replaced by reconnecting) into this account's connection, so performance history, holds and change sets carry over. The older record is kept and moved onto this account's connection, the record at :adAccount is deleted, and the result is active and selected if either was selected. Find candidates in merge_candidate_ids from Get Ad Account.
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).
Body: from_ad_account_id (integer, required): the ad account whose history should be merged in. Must exist, be a different record, and share the same platform and platform account id (otherwise 422).
Returns the merged account (its id is from_ad_account_id).
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
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.