New paused ad
create_adCreate a paused ad in an ad group (no spend; enabling is a status proposal). mode=copy: from an existing ad of the account source_ad_id (Meta — its creative, name required; Google — an RSA copy). mode=new, Google: a responsive search ad with headlines (3–15, up to 30 characters), descriptions (2–4, up to 90), final_url (https), path1/path2; Google image and video ads are created together with a Performance Max, Demand Gen or Display campaign (create_campaign). mode=new, Meta: name and page_id (from meta_ads.get_pages) or source_ad_id (an existing ad whose Facebook Page is used); Instagram: instagram=auto (default; the Page's page-backed profile when the client has no Instagram), page or none, or instagram_user_id; then format image — image_url, primary_text, headline, optional description, link, call_to_action; format carousel — 2–10 cards (image_url, headline, optional description, link), primary_text, link, call_to_action; format video — video_url (a direct https link to the video file), image_url as the cover, primary_text, headline, link, call_to_action. Images are public https links to PNG or JPEG files up to 5 MB; the server downloads them. Microsoft: mode=new only — a responsive search ad with the same fields as Google. LinkedIn: mode=new — a creative in the campaign's only ad group: name and primary_text (the post text), then format image — image_url, headline, link and call_to_action (APPLY, LEARN_MORE, SIGN_UP, REGISTER, DOWNLOAD, SUBSCRIBE, REQUEST_DEMO, JOIN, ATTEND, VIEW_QUOTE, SEE_MORE, BUY_NOW, SHOP_NOW); format video — video_url (a direct https link to an MP4 up to 200 MB), headline, link and call_to_action, only in a video campaign; format carousel — 2–10 cards (image_url, headline, link; no description), no button, only in a carousel campaign; format document — document_url (a direct https link to a PDF up to 100 MB) and headline (the document title), in a campaign without image or video creatives (engagement or awareness). The campaign format is set by create_campaign linkedin_format.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | ||
| mode | No | ||
| name | No | ||
| cards | No | Carousel cards (2–10) | |
| path1 | No | ||
| path2 | No | ||
| format | No | ||
| page_id | No | Meta: Facebook Page id from get_pages (otherwise the source ad's Page) | |
| headline | No | ||
| ad_set_id | Yes | The service ad group id or the platform's ad group id (external_id) | |
| apply_utm | No | ||
| final_url | No | ||
| headlines | No | ||
| image_url | No | A public https link to a PNG or JPEG file up to 5 MB; the server downloads it (Meta image ad, or the cover of a video ad) | |
| No | Meta: auto — the source ad's Instagram or the Page's page-backed profile; page — always the page-backed profile (client without Instagram); none — no Instagram (Facebook-only ad sets) | ||
| video_url | No | A direct https link to the video file (Meta video ad; LinkedIn — MP4 up to 200 MB) | |
| image_hash | No | Instant Form image from this account get_images; instead of image_url | |
| description | No | ||
| descriptions | No | ||
| document_url | No | LinkedIn document ad: a direct https link to a PDF file up to 100 MB | |
| lead_form_id | No | Meta Instant Form id on the ad Page; requires LEAD_GENERATION/ON_AD ad set | |
| primary_text | No | ||
| source_ad_id | No | ||
| text_options | No | Meta image ad: up to 4 more primary text variants | |
| call_to_action | No | Meta button type, for example LEARN_MORE, SHOP_NOW, SIGN_UP, CONTACT_US, BOOK_NOW, GET_QUOTE, ORDER_NOW | |
| optimize_order | No | ||
| headline_options | No | Meta image ad: up to 4 more headline variants | |
| instagram_user_id | No | Meta: a real Instagram account assigned to the ad account | |
| native_creative_id | No | Recover a partial Instant Form creative after live metadata read; all Page/form/image/text fields are rechecked before paused ad creation | |
| vertical_image_url | No | A public https link to a PNG or JPEG file up to 5 MB; the server downloads it — Meta image ad: a 9:16 image for Stories and Reels; image_url then serves feeds (4:5 or 1:1). Swapped automatically by size if given the other way round | |
| disable_enhancements | No | Meta new ad: turn off Meta's automatic creative enhancements (templates, touch-ups, animation, text variations) — for banners with text |