LinkedIn AdsVersion: v3

Get ad campaign group

GET/ad-publishing/linkedin/ads/{adId}

Retrieve a LinkedIn ad campaign group by ID

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

Path Parameters

adIdstringrequired

Ad identifier

Example:507f1f77bcf86cd799439011

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Response

application/json

The campaign group with its ad campaigns and their ads

idstringrequired

Campaign group identifier

Example:6a840c5a1c2e6acf77b1d258

namestringrequired

Campaign group name

Example:Q3 demand generation

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit

linkedInAdAccountIdstringrequired

LinkedIn ad account id the group belongs to

Example:556129919

adCampaignGroupIdstring

LinkedIn campaign group id, set once published

Example:1192521246

publishingStatusstringrequired

Publishing status

Example:PAUSED

linkedInErrorstringrequired

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

Example:

objectiveTypestringrequired

Campaign objective

Available optionsLEAD_GENERATIONWEBSITE_VISIT

Example:WEBSITE_VISIT

adBudgetOptimizationstring

Budget optimisation mode

Available optionsMAXIMUM_DELIVERYCOST_CAP

Example:MAXIMUM_DELIVERY

budgetobjectrequired

Budget configuration

adCampaignsobject[]required

Ad campaigns with their ads

adCampaigns[].idstringrequired

Ad campaign identifier

Example:6a840c7b1c2e6acf77b1d2a5

adCampaigns[].namestringrequired

Ad campaign name

Example:Ad set 1

adCampaigns[].adCampaignGroupIdstringrequired

Parent campaign group id

Example:6a840c5a1c2e6acf77b1d258

adCampaigns[].adCampaignIdstring

LinkedIn campaign id, set once published

Example:869320926

adCampaigns[].publishingStatusstringrequired

Publishing status

Example:PAUSED

adCampaigns[].linkedInErrorstringrequired

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

Example:

adCampaigns[].campaignTypestringrequired

Campaign type

Available optionsSPONSORED_UPDATES

Example:SPONSORED_UPDATES

adCampaigns[].mediaTypestringrequired

Creative format

Available optionsSTANDARD_UPDATECAROUSELSINGLE_VIDEO

Example:STANDARD_UPDATE

adCampaigns[].localeobjectrequired

Campaign locale

adCampaigns[].unitCostobject

Bid configuration

adCampaigns[].audienceobjectrequired

Targeting

adCampaigns[].adsobject[]required

Ads in this campaign

adCampaigns[].ads[].idstringrequired

Ad identifier

Example:6a840c7b1c2e6acf77b1d2a8

adCampaigns[].ads[].namestringrequired

Ad name

Example:Ad 1

adCampaigns[].ads[].adCampaignIdstringrequired

Parent ad campaign id

Example:6a840c7b1c2e6acf77b1d2a5

adCampaigns[].ads[].adCampaignGroupIdstringrequired

Parent campaign group id

Example:6a840c5a1c2e6acf77b1d258

adCampaigns[].ads[].adIdstring

LinkedIn ad id, set once published

Example:1554451156

adCampaigns[].ads[].publishingStatusstringrequired

Publishing status

Example:FAILED

adCampaigns[].ads[].linkedInErrorstringrequired

Rejection or publish error from LinkedIn. Empty string when there is none.

Example:

adCampaigns[].ads[].introductoryTextstringrequired

Body copy above the creative

Example:Grow your pipeline this quarter

adCampaigns[].ads[].descriptionstringrequired

Ad description

Example:

adCampaigns[].ads[].destinationUrlstringrequired

Click destination

Example:https://example.com

adCampaigns[].ads[].destinationFormIdstringrequired

Lead form id when the ad routes to a form instead of a URL

Example:

adCampaigns[].ads[].callToActionLabelstringrequired

Call-to-action button label

Example:APPLY

adCampaigns[].ads[].contentReferenceStringstring

URN of the underlying LinkedIn share, set once published

Example:urn:li:share:7495384246371512320

adCampaigns[].ads[].mediaobject[]required

Creative media

adCampaigns[].ads[].createdAtstringrequired

Created at

Example:2026-08-18T07:40:43.385Z

adCampaigns[].ads[].updatedAtstringrequired

Updated at

Example:2026-08-18T07:45:04.624Z

adCampaigns[].createdAtstringrequired

Created at

Example:2026-08-18T07:40:43.369Z

adCampaigns[].updatedAtstringrequired

Updated at

Example:2026-08-18T07:45:04.746Z

metaobject

Ancillary metadata

unpublishedChangesboolean

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

Example:true

createdBystringrequired

User who created the group

Example:uPy3hdVIuuNlbWOpBYGw

updatedBystringrequired

User who last updated the group

Example:uPy3hdVIuuNlbWOpBYGw

createdAtstringrequired

Created at

Example:2026-08-18T07:40:10.354Z

updatedAtstringrequired

Updated at

Example:2026-08-18T07:45:04.812Z

Get ad campaign group

Authorizations

Request​

Headers

Path Parameters

Query Parameters

Response

Request