Facebook IntegrationVersion: v3

Create Facebook integration

POST/ad-publishing/facebook/integration

Create a Facebook ad integration for a location with page and ad account

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

application/json

locationIdstringrequired

Location identifier

Example:loc_abc123

pageIdstringrequired

Facebook page ID

Example:123456789

adAccountIdstring

Ad account identifier

Example:act_123456

Response

application/json

The stored integration. Broader than the read — also returns the top-level userAccessToken.

idstringrequired

Integration identifier

Example:68b6e9577058423e35c3c358

locationIdstringrequired

Location identifier

Example:g8EFf47NY6PxodNBEHzP

statusstringrequired

Connection state

Available optionsconnectedexpireddisconnected

Example:connected

pricingModelstringrequired

How the location pays for ads

Available optionsdone_for_youconnect_your_bm

Example:connect_your_bm

userAccessTokenstringrequired

Live user access token for the connected Facebook user. Treat as a credential.

Example:<user-access-token>

fbAdAccountIdstring

Connected ad account id

Example:act_357046700569338

fbDefaultPageIdstring

Page used by default when publishing

Example:1180808591782587

pagesobject[]required

Pages linked to the integration, each with its access token

unSubscriptionReasonsstring[]required

Reasons the location previously unsubscribed. Empty array when none.

Example:[]

createdAtstringrequired

Created at

Example:2025-09-02T12:55:51.522Z

updatedAtstringrequired

Updated at

Example:2026-08-19T12:03:39.896Z