Skip to main content
Facebook IntegrationVersion: v3

Get Facebook integration

GET/ad-publishing/facebook/integration

Retrieve the Facebook ad integration details for a location

Authorizations

Authorizationstringheaderrequired

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

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

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Response

Facebook integration for the location. Includes a live access token per linked page.

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
fbAdAccountIdstring

Connected ad account id, prefixed with act_

Example:act_357046700569338
fbBusinessIdstring

Business Manager id. Absent on connect-your-BM integrations that have no business linked.

Example:153049965367635
fbDefaultPageIdstring

Page used by default when publishing

Example:1180808591782587
pagesobject[]required

Pages linked to the integration, each with its access token