Get ad campaign group

GET 
/ad-publishing/linkedin/ads/:adId

Retrieve a LinkedIn ad campaign group by ID

Request

Version stringrequired

API Version

Available optionsv3

adId stringrequired

Ad identifier

locationId stringrequired

Location identifier

application/json

The campaign group with its ad campaigns and their ads

application/json

Schema

Schema

idstringrequired

Campaign group identifier

namestringrequired

Campaign group name

locationIdstringrequired

Location identifier

linkedInAdAccountIdstringrequired

LinkedIn ad account id the group belongs to

adCampaignGroupIdstring

LinkedIn campaign group id, set once published

publishingStatusstringrequired

Publishing status

linkedInErrorstringrequired

Publish or review error from LinkedIn. Empty string when there is none.

objectiveTypestringrequired
Campaign objective
Available optionsLEAD_GENERATIONWEBSITE_VISIT
adBudgetOptimizationstring
Budget optimisation mode
Available optionsMAXIMUM_DELIVERYCOST_CAP
budgetobjectrequired

Budget configuration

adCampaignsobject[]required

Ad campaigns with their ads

metaobject

Ancillary metadata

unpublishedChangesboolean

Whether the group has edits not yet published. Absent on reads that have never been edited; set by the upsert.

createdBystringrequired

User who created the group

updatedBystringrequired

User who last updated the group

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

Example (auto)

{
  "id": "6a840c5a1c2e6acf77b1d258",
  "name": "Q3 demand generation",
  "locationId": "fRMewNQIxSyZ5R4nQyit",
  "linkedInAdAccountId": "556129919",
  "adCampaignGroupId": "1192521246",
  "publishingStatus": "PAUSED",
  "linkedInError": "",
  "objectiveType": "WEBSITE_VISIT",
  "adBudgetOptimization": "MAXIMUM_DELIVERY",
  "budget": {
    "budgetType": "DAILY",
    "amount": 30,
    "scheduleStartDate": "2026-08-18T07:40:10.110Z",
    "scheduleEndDate": "2026-09-17T07:40:10.110Z"
  },
  "adCampaigns": [
    {
      "id": "6a840c7b1c2e6acf77b1d2a5",
      "name": "Ad set 1",
      "adCampaignGroupId": "6a840c5a1c2e6acf77b1d258",
      "adCampaignId": "869320926",
      "publishingStatus": "PAUSED",
      "linkedInError": "",
      "campaignType": "SPONSORED_UPDATES",
      "mediaType": "STANDARD_UPDATE",
      "locale": {
        "country": "US",
        "language": "en"
      },
      "unitCost": {
        "amount": 1
      },
      "audience": {
        "geoLocations": [
          {
            "name": "Mumbai, Maharashtra, India",
            "urn": "urn:li:geo:106164952",
            "facetUrn": "urn:li:adTargetingFacet:locations",
            "selectionType": "include"
          }
        ],
        "targetAudience": {
          "include": [],
          "exclude": []
        }
      },
      "ads": [
        {
          "id": "6a840c7b1c2e6acf77b1d2a8",
          "name": "Ad 1",
          "adCampaignId": "6a840c7b1c2e6acf77b1d2a5",
          "adCampaignGroupId": "6a840c5a1c2e6acf77b1d258",
          "adId": "1554451156",
          "publishingStatus": "FAILED",
          "linkedInError": "",
          "introductoryText": "Grow your pipeline this quarter",
          "description": "",
          "destinationUrl": "https://example.com",
          "destinationFormId": "",
          "callToActionLabel": "APPLY",
          "contentReferenceString": "urn:li:share:7495384246371512320",
          "media": [
            {
              "type": "image",
              "src": "https://staging.files.leadconnectorhq.com/file/abc/def.png",
              "name": "creative.png",
              "headline": "Try it free",
              "destinationUrl": "example.com",
              "fileSizeBytes": 1066210,
              "urn": "urn:li:image:D5610AQEjSUtmzK0rjw",
              "_id": "6a840c881c2e6acf77b1d3c9"
            }
          ],
          "createdAt": "2026-08-18T07:40:43.385Z",
          "updatedAt": "2026-08-18T07:45:04.624Z"
        }
      ],
      "createdAt": "2026-08-18T07:40:43.369Z",
      "updatedAt": "2026-08-18T07:45:04.746Z"
    }
  ],
  "meta": {
    "evaluate": "{\"opportunityScore\":60,\"confidence\":\"High\",\"band\":\"Medium\",\"categories\":[],\"fixItems\":[]}"
  },
  "unpublishedChanges": true,
  "createdBy": "uPy3hdVIuuNlbWOpBYGw",
  "updatedBy": "uPy3hdVIuuNlbWOpBYGw",
  "createdAt": "2026-08-18T07:40:10.354Z",
  "updatedAt": "2026-08-18T07:45:04.812Z"
}