account | DynamicAccount | Yes | - | LinkedIn Ads account to create the ad set in. |
campaign_id | string or SelectItem | Yes | - | Parent campaign ID. This maps to LinkedIn campaignGroup. |
adset_name | string | Yes | - | Ad set name. |
objective_type | string or SelectableOption | Yes | - | Ad set objective. |
ad_format | string or SelectableOption | Yes | - | LinkedIn Campaign Manager ad format. |
associated_entity_urn | string | No | - | Organization or member URN required for sponsored content, dynamic ads, and lead gen forms. |
budget_type | string or SelectableOption | No | {'value': 'DAILY', 'label': 'Daily budget'} | Budget mode: DAILY, LIFETIME, or BOTH. |
daily_budget | number | No | - | Daily budget in the account currency. Currency is resolved by backend. |
total_budget | number | No | - | Lifetime/total budget in the account currency. Currency is resolved by backend. |
start_time | integer or string | No | - | Optional start date/time as Unix timestamp or ISO datetime. |
end_time | integer or string | No | - | Optional end date/time as Unix timestamp or ISO datetime. |
optimization_goal | string or SelectableOption | No | - | What LinkedIn optimizes delivery for. Objective-specific, e.g. REACH, IMPRESSIONS, LANDING_PAGE_CLICKS, ENGAGEMENT_CLICKS, WEBSITE_CONVERSIONS, LEADS, VIDEO_VIEWS, SENDS. |
bidding_strategy | string or SelectableOption | No | - | How bids are placed: MAX_DELIVERY (automated), TARGET_COST, or MANUAL. |
unit_cost | number | No | - | Optional bid amount in account currency. Required for manual bidding choices. |
locale_language | string | No | en | LinkedIn ad set locale language as a two-letter lowercase code, for example ‘en’. This is not audience targeting; it tells LinkedIn the language context for the campaign setup. Use the account/user market default unless the user explicitly needs another locale. |
locale_country | string | No | US | LinkedIn ad set locale country as a two-letter uppercase code, for example ‘US’. This is not the geographic audience target; it pairs with locale_language in the LinkedIn locale object. Use the account/user market default unless the user explicitly needs another locale. |
targeting_criteria | object or string | Yes | - | LinkedIn targetingCriteria object for the ad set. Use this to define the actual audience, including required locations and any other facets such as industries, job titles, company sizes, or exclusions. Use linkedin_ads_search_targeting operation to explore available URNs for locations, job titles, companies, industries, skills, and other targeting facets. Do not invent LinkedIn URNs or IDs. Pass either a dict or a valid JSON string matching LinkedIn’s targetingCriteria shape, for example {‘include’: {‘and’: [{‘or’: {‘urn:li:adTargetingFacet:locations’: [‘urn:li:geo:103644278’]}}]}}. This is audience targeting and is separate from locale_language/locale_country. |
conversion_ids | array of string or SelectItem | No | - | Optional existing LinkedIn conversion rule IDs or URNs to associate with the ad set after it is created. Use linkedin_ads_list_conversions to find available conversions. Accepts IDs like 104012 or URNs like urn:lla:llaPartnerConversion:104012. |
audience_expansion_enabled | boolean | No | False | Enable LinkedIn audience expansion. |
offsite_delivery_enabled | boolean | No | False | Enable LinkedIn Audience Network/offsite delivery. |
creative_selection | string or SelectableOption | No | {'value': 'OPTIMIZED', 'label': 'Optimized'} | Creative rotation strategy. |
political_intent | string or SelectableOption | No | {'value': 'NOT_DECLARED', 'label': 'Not declared'} | Political advertising declaration. |
status | string or SelectableOption | No | {'value': 'PAUSED', 'label': 'Paused'} | Initial ad set status. |
