account | DynamicAccount | Yes | - | LinkedIn Ads account to create the ad in. |
update_type | string or SelectableOption | Yes | - | Create a single text ad (‘single’) or many at once (‘bulk’). |
adset_id | string or SelectItem | No | - | Text ad set (LinkedIn sponsored campaign) the ad belongs to. |
image_url | string | No | - | Optional 100x100 text ad image. Accepts a direct image URL or a Google Drive share link (set to ‘Anyone with the link’). Markifact uploads it to LinkedIn automatically. |
headline | string | No | - | Text ad headline. Required. Up to 25 characters. |
description | string | No | - | Text ad description. Required. Up to 75 characters. |
destination_url | string | No | - | Landing page URL. Required. Up to 500 characters. |
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: adset_id, image_url, headline, description, destination_url, 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. |
