LinkedIn AdsVersion: v3

Upsert ad campaign group

PUT/ad-publishing/linkedin/ads

Create or update a LinkedIn ad campaign group with campaigns and ads

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

Body

application/json

idstring

Internal ID

Example:cg_abc123

locationIdstringrequired

Location ID

Example:loc_abc123

budgetobject

Campaign group budget

adCampaignsobject[]

Child ad campaigns

adCampaigns[].idstring

Internal campaign identifier

Example:camp_abc123

adCampaigns[].localeobject

Campaign locale

adCampaigns[].namestring

Campaign name

Example:Q1 Lead Gen Campaign

adCampaigns[].publishingStatusstring

Publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

adCampaigns[].mediaTypestring

Creative media type for the campaign

Available optionsSTANDARD_UPDATESINGLE_VIDEOCAROUSEL

Example:STANDARD_UPDATE

adCampaigns[].audienceobject

Campaign audience targeting

adCampaigns[].unitCostobject

Bid unit cost

adCampaigns[].campaignTypestring

LinkedIn campaign type

Example:SPONSORED_UPDATES

adCampaigns[].adCampaignGroupIdstring

Parent campaign group identifier

Example:cg_abc123

adCampaigns[].adCampaignIdstring

LinkedIn campaign resource ID

Example:123456789

adCampaigns[].adsobject[]

Ads in the 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[].linkedInErrorstring

LinkedIn API error message

Example:Bid below minimum

adCampaigns[].metaobject

Additional campaign metadata

adBudgetOptimizationstring

Ad budget optimization mode

Available optionsMAXIMUM_DELIVERYCOST_CAP

Example:MAXIMUM_DELIVERY

objectiveTypestring

Campaign group objective

Available optionsLEAD_GENERATIONWEBSITE_VISIT

Example:LEAD_GENERATION

namestring

Campaign group name

Example:Q1 Lead Gen

adCampaignGroupIdstring

LinkedIn campaign group resource ID

Example:123456789

publishingStatusstring

Publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

linkedInAdAccountIdstring

LinkedIn ad account identifier

Example:12345678

unpublishedChangesboolean

Whether the campaign group has unpublished changes

Example:false

metaobject

Additional metadata

linkedInErrorstring

LinkedIn API error message

Example:Budget below minimum

customValueMappingsobject

User-provided overrides for custom_values merge tags used in ad copy

Response

application/json

The saved campaign group, same shape as GET /linkedin/ads/{adId}

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

Upsert ad campaign group

Authorizations

Request​

Headers

Body

Response

Request