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.

Request

Version stringrequired

API Version

Available optionsv3

campaignId stringrequired

Campaign identifier

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

Example (auto)

{
  "locationId": "loc_abc123"
}

application/json

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

application/json

Schema

Schema

idstringrequired

Campaign identifier

namestringrequired

Campaign name

locationIdstringrequired

Location identifier

fbAdAccountIdstringrequired

Ad account the campaign belongs to

fbCampaignIdstring

Facebook campaign id, set once published

objectivestringrequired

Campaign objective

specialAdCategoriesstring[]required

Special ad categories declared for the campaign

publishingStatusstringrequired
Publishing status of the campaign itself. Independent of its children — pausing one ad set leaves the campaign PUBLISHED.
Available optionsDRAFTSCHEDULEDPUBLISHINGPUBLISHEDPAUSEDIN_REVIEWWITH_ISSUESREJECTEDARCHIVEDFAILED
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.

sourcestringrequired

Where the campaign was created from

metaobject

Ancillary campaign metadata

unpublishedChangesboolean

Whether the campaign has edits not yet published

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

adsetsobject[]required

Ad sets with their ads

Example (auto)

{
  "id": "6a323f3e4454921db1498ccf",
  "name": "Spring promotion",
  "locationId": "fRMewNQIxSyZ5R4nQyit",
  "fbAdAccountId": "act_357046700569338",
  "fbCampaignId": "120250378905720122",
  "objective": "OUTCOME_LEADS",
  "specialAdCategories": [
    "NONE"
  ],
  "publishingStatus": "DRAFT",
  "fbError": null,
  "source": "AD_MANAGER",
  "meta": {
    "evaluate": "{\"opportunityScore\":25,\"band\":\"Low\",\"categories\":[],\"fixItems\":[],\"sacCompliance\":{\"applicable\":false}}"
  },
  "unpublishedChanges": false,
  "createdAt": "2026-06-17T06:31:26.599Z",
  "updatedAt": "2026-08-19T11:45:39.340Z",
  "adsets": [
    {
      "id": "6a323f3f4454921db1498cd8",
      "name": "Ad set 1",
      "campaignId": "6a323f3e4454921db1498ccf",
      "fbAdSetId": "120250378906150122",
      "publishingStatus": "PUBLISHED",
      "fbError": null,
      "pageId": "196684453527082",
      "instagramActorId": null,
      "messagingPlatforms": [],
      "conversionLocation": "on_ad",
      "budget": {
        "budgetType": "DAILY",
        "amount": 1,
        "actualAmount": 1
      },
      "audience": {
        "genders": [
          0
        ],
        "geoLocations": [
          {
            "key": "IN",
            "name": "India",
            "type": "country",
            "selectionType": "include",
            "radius": 17,
            "radiusUnit": "km",
            "geometry": {
              "location": {
                "lat": 20.593684,
                "lng": 78.96288
              },
              "locationType": "APPROXIMATE"
            }
          }
        ],
        "ageMin": 18,
        "ageMax": 65,
        "interests": [
          {
            "id": "6016286626383",
            "name": "Facebook access (mobile): tablets",
            "type": "behaviors"
          }
        ],
        "placements": {
          "facebook": [
            "feed",
            "story"
          ],
          "instagram": [
            "reels"
          ],
          "messenger": [
            "messenger_home"
          ]
        },
        "placementType": "manual"
      },
      "unpublishedChanges": false,
      "createdAt": "2026-06-17T06:31:27.129Z",
      "updatedAt": "2026-08-19T11:42:35.835Z",
      "ads": [
        {
          "id": "6a323f3f4454921db1498ce1",
          "name": "Ad 1",
          "campaignId": "6a323f3e4454921db1498ccf",
          "adsetId": "6a323f3f4454921db1498cd8",
          "fbAdId": "120250378908850122",
          "publishingStatus": "PUBLISHED",
          "fbError": null,
          "mediaType": "SINGLE",
          "cta": "GET_OFFER",
          "multiAdvertiserAds": true,
          "primaryTexts": [
            {
              "text": "Book a free demo",
              "_id": "6a3245204454921db1499735"
            }
          ],
          "headlines": [
            {
              "text": "Book a free demo",
              "_id": "6a3245204454921db1499735"
            }
          ],
          "descriptions": [
            {
              "text": "Book a free demo",
              "_id": "6a3245204454921db1499735"
            }
          ],
          "primaryText": "Get an instant estimate",
          "headline": "Free home valuation",
          "description": "Fast and hassle-free",
          "media": [
            {
              "type": "image",
              "src": "https://staging.files.leadconnectorhq.com/file/abc/def.jpeg",
              "name": "creative.jpeg",
              "_id": "6a859661867e604d24f4d73d"
            }
          ],
          "destinationFormId": "36267736432839880",
          "destinationLink": null,
          "unpublishedChanges": false,
          "createdAt": "2026-06-17T06:31:27.661Z",
          "updatedAt": "2026-08-19T11:45:39.340Z"
        }
      ]
    }
  ]
}