account | DynamicAccount | Yes | - | LinkedIn Ads account to create the ad in. |
update_type | string or SelectableOption | Yes | - | Create a single image ad (‘single’) or many at once (‘bulk’). |
adset_id | string or SelectItem | No | - | Ad set (LinkedIn sponsored campaign) the ad belongs to. Maps to the creative’s campaign. |
organization | string or SelectItem | Yes | - | Company Page used as the post author. Accepts an organization id or urn:li:organization:123. |
image_url | string | No | - | Image for the ad. Accepts a direct image URL or a Google Drive share link (set to ‘Anyone with the link’). Markifact uploads it to LinkedIn automatically. |
intro_text | string | No | - | Introductory text shown above the image. Up to 255 characters. |
headline | string | No | - | Headline shown below the image. Up to 70 characters. LinkedIn only saves a headline together with a destination_url (the headline is the link preview title), so set both or neither. Cannot be changed after the ad is created. |
description | string | No | - | Optional description (LinkedIn Audience Network only). Up to 70 characters. |
destination_url | string | No | - | Landing page URL the ad clicks through to. Required unless a lead form is set. |
lead_form | string or SelectItem | No | - | Optional LinkedIn lead-gen form. Provide this for Lead Generation ad sets: the ad opens this form instead of a destination URL. Accepts a form id or urn:li:adForm:123. |
call_to_action | string or SelectableOption | No | - | Call-to-action button label (e.g. LEARN_MORE, SIGN_UP, DOWNLOAD). |
ad_name | string | No | - | Optional creative name. Up to 255 characters. |
status | string or SelectableOption | No | {'value': 'DRAFT', 'label': 'Draft'} | Initial creative status: DRAFT (safely inactive) or ACTIVE (submitted for review). |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is ‘bulk’, typically the output of a Sheets read. Each row supports: image_url, adset_id, intro_text, headline, description, destination_url, lead_form, call_to_action, ad_name, status. |
return_detailed_results | boolean | No | False | Bulk mode only. If true, returns per-row results and does not raise on partial failures so the workflow can continue. Default false. |