Create Google integration

POST 
/ad-publishing/google/integration

Create a Google Ads integration for a location

Request

Version stringrequired

API Version

Available optionsv3

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

adAccountIdstringrequired

Ad account identifier

mccIdstringrequired

MCC identifier

Example (auto)

{
  "locationId": "loc_abc123",
  "adAccountId": "123-456-7890",
  "mccId": "987-654-3210"
}

application/json

The stored integration. Returns the raw document, so the id is _id.

application/json

Schema

Schema

_idstringrequired

Integration identifier, as _id rather than id

__vnumberrequired

Mongoose internal version key

locationIdstringrequired

Location identifier

statusstringrequired
Connection state
Available optionsconnectedexpireddisconnected
adAccountIdstringrequired

Connected Google Ads customer id

mccIdstringrequired

Manager (MCC) customer id above the account

userIdstringrequired

Google People API resource name of the connected user

connectionIdstringrequired

Identifier of the OAuth connection backing this integration

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

Example (auto)

{
  "_id": "677ebaed998e79ec25fc612b",
  "__v": 0,
  "locationId": "fRMewNQIxSyZ5R4nQyit",
  "status": "connected",
  "adAccountId": "6776452901",
  "mccId": "6776452901",
  "userId": "people/1154723318699",
  "connectionId": "gZddldBd8SWA7C",
  "createdAt": "2025-01-08T17:50:37.952Z",
  "updatedAt": "2026-08-19T08:12:05.304Z"
}