LinkedIn Ads
Draft LinkedIn Ad Campaign
Create a LinkedIn campaign as DRAFT with budget, schedule, targeting, bidding strategy, optimisation goal and ad rotation. Maximum delivery defaults to CPM and an objective-based goal; Manual needs bidAmount and Cost cap needs costCap. Saved manual bids remain manual. Optional conversionIds attach only verified rules in the selected account after creation; partial failures retain the campaign ID. Rotation defaults to ROUND_ROBIN, Audience Expansion and Audience Network stay off. Creation never starts delivery.
Endpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| adAccountIdstring · required | string | required | — |
| campaignGroupIdstring · required | string | required | From Draft LinkedIn Campaign Group |
| namestring · required | string | required | — |
| typestring · optional | string | optional | One of: |
| objectiveTypestring · optional | string | optional | One of: |
| costTypestring · optional | string | optional | What LinkedIn charges for. Maximum delivery and Cost cap require CPM; Manual defaults to CPC and also supports CPM/CPV. One of: |
| dailyBudgetstring · optional | string | optional | Whole currency units — 50 means 50.00, NOT cents |
| totalBudgetstring · optional | string | optional | Whole currency units. Requires an end date. |
| bidAmountstring · optional | string | optional | Manual bid, required for MANUAL only. A saved bid without an explicit strategy stays Manual. Omit for Maximum delivery; use costCap for Cost cap., in whole currency units of the ad account's own currency — 50 means 50.00. This is NOT cents: 5000 would mean five thousand. |
| locationUrnsstring · optional | string | optional | Location IDs from Search LinkedIn Targeting Locations |
| targetingCriteriaobject · optional | object | optional | Replaces the Locations field |
| localeCountrystring · optional | string | optional | Two letters, default US |
| localeLanguagestring · optional | string | optional | Two letters, default en |
| startDatestring · optional | string | optional | ISO date. Defaults to now. |
| endDatestring · optional | string | optional | ISO date. Required with a total budget. |
| audienceExpansionEnabledboolean · optional | boolean | optional | Also show the ad to similar audiences. Off by default. |
| offsiteDeliveryEnabledboolean · optional | boolean | optional | Also deliver off LinkedIn. Off by default. |
| biddingStrategystring · optional | string | optional | Maximum delivery uses automated CPM bidding. Cost cap requires costCap. Manual requires bidAmount. Without a strategy, a saved manual bid stays manual; otherwise default to Maximum delivery. One of: |
| costCapstring · optional | string | optional | Cost cap per optimized result in ordinary account currency units, required only for COST_CAP. 5 means 5.00, not cents. |
| optimizationTargetTypestring · optional | string | optional | Optimization goal. MAX_* goals use Maximum delivery, CAP_COST_* goals use Cost cap, NONE/ENHANCED_CONVERSION use Manual. Defaults follow the selected strategy and objective. LinkedIn still validates format/objective eligibility. One of: |
| creativeSelectionstring · optional | string | optional | ROUND_ROBIN rotates ads evenly (default); OPTIMIZED prioritizes expected performance. Message ads support OPTIMIZED only with LEAD_GENERATION. One of: |
| conversionIdsstring · optional | string | optional | JSON array of up to 20 existing conversion IDs or urn:lla:llaPartnerConversion:<id> URNs to attach after draft creation. Each rule must belong to the selected ad account. Omit to attach none. |