Facebook AdsVersion: v3

Publish campaign

POST/ad-publishing/facebook/campaigns/{campaignId}/publish

Queue a Facebook campaign for publishing and push it live to Facebook. Publishing runs asynchronously, so the campaign comes back in the state it was queued in — publishingStatus is still DRAFT on the campaign and on every ad set and ad, and no Facebook ids are attached yet. Poll GET /facebook/campaigns/{campaignId}/publishing-progress for the outcome.

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

Path Parameters

campaignIdstringrequired

Campaign identifier

Example:507f1f77bcf86cd799439011

Body

application/json

locationIdstringrequired

Location identifier

Example:loc_abc123

Response

application/json

The campaign with its ad sets and ads, as queued for publishing

idstringrequired

Campaign identifier

Example:6a323f3e4454921db1498ccf

namestringrequired

Campaign name

Example:Spring promotion

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit

fbAdAccountIdstringrequired

Ad account the campaign belongs to

Example:act_357046700569338

fbCampaignIdstring

Facebook campaign id, set once published

Example:120250378905720122

objectivestringrequired

Campaign objective

Example:OUTCOME_LEADS

specialAdCategoriesstring[]required

Special ad categories declared for the campaign

Example:["NONE"]

publishingStatusstringrequired

Publishing status of the campaign itself. Independent of its children — pausing one ad set leaves the campaign PUBLISHED.

Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED

Example:DRAFT

fbErrorstringnullable

Despite the name this is not always an error. Reads return null when there is nothing to report and the upsert returns "", but pausing an ad set or an ad overwrites it with an informational notice — One or more adsets are paused or One or more ads are paused — which the matching resume clears back to null. Treat it as a status line, not a failure signal.

Example:null

sourcestringrequired

Where the campaign was created from

Example:AD_MANAGER

metaobject

Ancillary campaign metadata

unpublishedChangesboolean

Whether the campaign has edits not yet published

Example:false

createdAtstringrequired

Created at

Example:2026-06-17T06:31:26.599Z

updatedAtstringrequired

Updated at

Example:2026-08-19T11:45:39.340Z

adsetsobject[]required

Ad sets with their ads

adsets[].idstringrequired

Ad set identifier

Example:6a323f3f4454921db1498cd8

adsets[].namestringrequired

Ad set name

Example:Ad set 1

adsets[].campaignIdstringrequired

Parent campaign id

Example:6a323f3e4454921db1498ccf

adsets[].fbAdSetIdstring

Facebook ad set id, set once published

Example:120250378906150122

adsets[].publishingStatusstringrequired

Publishing status. On a published entity this is not the state you asked for but the effective_status Meta reports, mapped back — a pause or resume re-reads it live, so an ad awaiting review comes back IN_REVIEW rather than PAUSED or PUBLISHED. Any effective status this service does not recognise also maps to IN_REVIEW.

Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED

Example:PUBLISHED

adsets[].fbErrorstringnullable

Publish error from Facebook. null on reads when there is none.

Example:null

adsets[].pageIdstringrequired

Page the ads run under

Example:196684453527082

adsets[].instagramActorIdstringnullable

Instagram account the ads run under. null when not linked.

Example:null

adsets[].messagingPlatformsstring[]required

Messaging destinations for click-to-message ads. Empty for other conversion locations.

Example:["MESSENGER","INSTAGRAM_DIRECT"]

adsets[].conversionLocationstring

Where the conversion happens

Example:on_ad

adsets[].budgetobjectrequired

Budget configuration

adsets[].audienceobjectrequired

Targeting

adsets[].audience.gendersnumber[]required

Genders as Facebook numeric codes, not names — 0 all, 1 male, 2 female. Empty array also means all.

Example:[0]

adsets[].audience.geoLocationsobject[]required

Geographic targeting

adsets[].audience.ageMinnumber

Minimum age targeted

Example:18

adsets[].audience.ageMaxnumber

Maximum age targeted

Example:65

adsets[].audience.interestsobject[]

Interest and behaviour targeting

adsets[].audience.placementsobject

Placement positions per platform. Only meaningful when placementType is manual.

adsets[].audience.placementTypestring

Placement strategy

Available optionsautomanual

Example:manual

adsets[].unpublishedChangesboolean

Whether the ad set has edits not yet published

Example:false

adsets[].createdAtstringrequired

Created at

Example:2026-06-17T06:31:27.129Z

adsets[].updatedAtstringrequired

Updated at

Example:2026-08-19T11:42:35.835Z

adsets[].adsobject[]required

Ads in this ad set

adsets[].ads[].idstringrequired

Ad identifier

Example:6a323f3f4454921db1498ce1

adsets[].ads[].namestringrequired

Ad name

Example:Ad 1

adsets[].ads[].campaignIdstringrequired

Parent campaign id

Example:6a323f3e4454921db1498ccf

adsets[].ads[].adsetIdstringrequired

Parent ad set id

Example:6a323f3f4454921db1498cd8

adsets[].ads[].fbAdIdstring

Facebook ad id, set once published

Example:120250378908850122

adsets[].ads[].publishingStatusstringrequired

Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED

Example:PUBLISHED

adsets[].ads[].fbErrorstringnullable

Publish error from Facebook. null on reads when there is none.

Example:null

adsets[].ads[].mediaTypestringrequired

Creative format

Example:SINGLE

adsets[].ads[].ctastring

Call-to-action button

Example:GET_OFFER

adsets[].ads[].multiAdvertiserAdsbooleanrequired

Whether multi-advertiser ads are enabled

Example:true

adsets[].ads[].primaryTextsobject[]required

Primary text variants. Used by SINGLE image and video ads.

adsets[].ads[].headlinesobject[]required

Headline variants

adsets[].ads[].descriptionsobject[]required

Description variants

adsets[].ads[].primaryTextstring

Single primary text. Carried alongside primaryTexts, mirroring its first entry.

Example:Get an instant estimate

adsets[].ads[].headlinestring

Single headline. Used by carousel ads; mirrors the first headlines entry otherwise.

Example:Free home valuation

adsets[].ads[].descriptionstring

Single description

Example:Fast and hassle-free

adsets[].ads[].mediaobject[]required

Creative media

adsets[].ads[].destinationFormIdstring

Instant form the ad routes to, when the conversion location is on-ad

Example:36267736432839880

adsets[].ads[].destinationLinkstringnullable

Click destination. null when the ad routes to an instant form instead.

Example:null

adsets[].ads[].unpublishedChangesboolean

Whether the ad has edits not yet published

Example:false

adsets[].ads[].createdAtstringrequired

Created at

Example:2026-06-17T06:31:27.661Z

adsets[].ads[].updatedAtstringrequired

Updated at

Example:2026-08-19T11:45:39.340Z

Publish campaign

Authorizations

Request​

Headers

Path Parameters

Body

Response

Request