create_meta_ad_draft
Create a complete Meta (Facebook/Instagram) ad draft — campaign + ad set + creative + ad — ALL in PAUSED state, spending nothing. Use when the user wants to set up or draft an ad. Activation is a separate human-approved step (set_meta_ad_status).
[sensitive-tier — first use may require a manager's approval; a from-now-on approval makes future calls seamless, a just-once approval re-asks next time.]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cta | No | Optional call-to-action: LEARN_MORE, SIGN_UP, GET_STARTED, CONTACT_US, DOWNLOAD, SUBSCRIBE | |
| link_url | Yes | https destination URL (landing page, with UTMs) | |
| companyId | Yes | FreedomOS company id to act within (you must be a member). Required for company-scoped tools. | |
| objective | No | OUTCOME_TRAFFIC (default) | OUTCOME_AWARENESS | OUTCOME_ENGAGEMENT | |
| targeting | No | Audience: {countries: ["US"], age_min, age_max, interests: [{id, name}]} | |
| daily_budget | Yes | Daily budget in the account currency, major units (e.g. 25 = 25 USD/day) | |
| primary_text | Yes | The ad copy (primary text) | |
| ad_account_id | No | Ad account (act_<digits>). Optional when the connection has exactly one. | |
| campaign_name | Yes | Campaign name, e.g. "PCAI cold traffic — Compliance Crusader v1" | |
| image_artifact_id | No | Optional agent_artifacts image id for the creative |