Skip to main content
Google IntegrationVersion: v3

Create Google integration

POST/ad-publishing/google/integration

Create a Google Ads integration for a location

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Body

locationIdstringrequired

Location identifier

Example:loc_abc123
adAccountIdstringrequired

Ad account identifier

Example:123-456-7890
mccIdstringrequired

MCC identifier

Example:987-654-3210

Response

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

_idstringrequired

Integration identifier, as _id rather than id

Example:677ebaed998e79ec25fc612b
__vnumberrequired

Mongoose internal version key

Example:0
locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit
statusstringrequired

Connection state

Available optionsconnectedexpireddisconnected
Example:connected
adAccountIdstringrequired

Connected Google Ads customer id

Example:6776452901
mccIdstringrequired

Manager (MCC) customer id above the account

Example:6776452901
userIdstringrequired

Google People API resource name of the connected user

Example:people/1154723318699
connectionIdstringrequired

Identifier of the OAuth connection backing this integration

Example:gZddldBd8SWA7C
createdAtstringrequired

Created at

Example:2025-01-08T17:50:37.952Z
updatedAtstringrequired

Updated at

Example:2026-08-19T08:12:05.304Z