Publish ad

POST 
/ad-publishing/google/ads/:adId/publish

Publish a Google ad and push it live

Request

Version stringrequired

API Version

Available optionsv3

adId stringrequired

Ad identifier

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

Example (auto)

{
  "locationId": "HChooFuiyPpVYzeJ4HMe"
}

application/json

The campaign moved to PUBLISHING. Returns the raw document, so the id is _id and adGroups are not populated.

application/json

Schema

Schema

_idstringrequired

Campaign identifier, as _id rather than id

__vnumberrequired

Mongoose internal version key

namestringrequired

Campaign name

locationIdstringrequired

Location identifier

googleAdAccountIdstringrequired

Google Ads customer id

advertisingChannelTypestringrequired
Advertising channel
Available optionsSEARCHDEMAND_GEN
publishingStatusstringrequired
Status after the publish request, normally PUBLISHING
Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED
sourcestringrequired

Where the campaign was created from

budgetobjectrequired

Budget configuration

networkSettingsobjectrequired

Network placement settings

biddingStrategyobjectrequired

Bidding configuration. value is omitted for strategies that do not take a target.

assetsobjectrequired

Attached assets by kind

audienceobjectrequired

Campaign level targeting

adScheduleobject[]required

Ad scheduling windows

metaobject

Ancillary campaign metadata

googleErrorstringnullable

Publish error from Google, null when the request was accepted

isEuPoliticalAdsbooleanrequired

Whether the campaign is declared as EU political advertising

createdBystringrequired

User who created the campaign

updatedBystringrequired

User who last updated the campaign

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

Example (auto)

{
  "_id": "6a8438b2b112242a53b1ea6a",
  "__v": 6,
  "name": "Spring promotion",
  "locationId": "fRMewNQIxSyZ5R4nQyit",
  "googleAdAccountId": "6776452901",
  "advertisingChannelType": "SEARCH",
  "publishingStatus": "PUBLISHING",
  "source": "AD_MANAGER",
  "budget": {
    "budgetType": "DAILY",
    "amount": 50,
    "scheduleStartDate": "2026-08-18T00:00:00.000Z",
    "scheduleEndDate": "2026-09-18T00:00:00.000Z"
  },
  "networkSettings": {
    "targetSearchNetwork": true,
    "targetContentNetwork": false
  },
  "biddingStrategy": {
    "type": "MAXIMIZE_CONVERSIONS",
    "value": 0
  },
  "assets": {
    "calls": [],
    "sitelinks": [],
    "leadForm": "",
    "images": []
  },
  "audience": {
    "locales": [
      {
        "name": "English",
        "key": "1000",
        "id": "1000",
        "resourceName": "languageConstants/1000"
      }
    ],
    "geoLocations": [
      {
        "key": "geoTargetConstants/2840",
        "id": "ChIJOwg_06VPwokRYv534QaPC8g",
        "name": "New York",
        "countryName": "United States",
        "type": "city",
        "radius": 25,
        "radiusUnit": "mi",
        "selectionType": "include",
        "resourceName": "customers/123/geoTargetConstants/2840",
        "placeId": "ChIJOwg_06VPwokRYv534QaPC8g",
        "formattedAddress": "New York, NY, USA",
        "geometry": {
          "location": {
            "lat": 40.7128,
            "lng": -74.006
          },
          "locationType": "APPROXIMATE"
        },
        "addressComponents": [
          {
            "longName": "New York",
            "shortName": "NY",
            "types": [
              "locality",
              "political"
            ]
          }
        ]
      }
    ],
    "gender": [
      {
        "enum": "MALE",
        "negative": false
      }
    ],
    "ageRange": [
      {
        "enum": "AGE_RANGE_25_34",
        "negative": false
      }
    ],
    "segments": [],
    "targetInterests": {
      "affinity": [],
      "inMarket": []
    }
  },
  "adSchedule": [
    {
      "dayOfWeek": "ALL_DAYS",
      "from": "09_00",
      "to": "17_30",
      "_id": "6a855ca9867e604d24f4b8fa"
    }
  ],
  "meta": {
    "evaluate": "{\"opportunityScore\":18,\"confidence\":\"High\",\"band\":\"Low\",\"categories\":[],\"fixItems\":[]}"
  },
  "googleError": null,
  "isEuPoliticalAds": false,
  "createdBy": "uPy3hdVIuuNlbWOpBYGw",
  "updatedBy": "hzN33mfYO5c1LHqsExRC",
  "createdAt": "2026-08-18T10:49:22.412Z",
  "updatedAt": "2026-08-19T08:10:33.333Z"
}