Create a marketing message campaign

Create a marketing message campaign in this ad account. Meta creates the campaign, ad set, ad and creative together in one call.

post/ad-accounts/{adAccountId}/campaigns

Beta

The External API is in beta. Endpoints, parameters, and response shapes may change — including breaking changes — in future releases. Pin to documented behavior before relying on it in production.

Authorization

x-api-key x-date x-signature x-api-version

x-api-key<token>

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.

In: header

x-signature<token>

HMAC-SHA256 of the x-date string keyed by your secret, lowercase hex.

In: header

x-api-version<token>

API version you're coding against — currently 1. Required; a missing or unsupported value returns 400 with Missing or unsupported x-api-version header. Supported versions: 1.

In: header

Path Parameters

adAccountId*string

The Meta ad account id.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Create a marketing message campaign. Send exactly one of dailyBudget / lifetimeBudget.

name*string

The campaign name.

pageId*string

The raw Facebook page id — one of this ad account's pages[].id values from GET /ad-accounts (not the FB_PAGE_… channel id).

dailyBudget?string

Daily budget as a string of digits in the ad account's minor currency units (e.g. "5000" = 50.00 USD). Exactly one of dailyBudget / lifetimeBudget is required.

lifetimeBudget?string

Lifetime budget as a string of digits in the ad account's minor currency units (e.g. "50000" = 500.00 USD). Lifetime-budget campaigns stop being deliverable 30 days after creation.

pixelId?string

Optional Meta pixel id to attach — discover ids with GET /ad-accounts/{adAccountId}/pixels.

adName?string

Optional ad name — defaults to the campaign name.

adsetName?string

Optional ad-set name — defaults to the campaign name.

Response Body

`application/json`

Try it

live — writes real data

Kept in this tab only and signed in your browser — your secret never leaves your device.

Path

adAccountId*The Meta ad account id.

Body

name*The campaign name.pageId*The raw Facebook page id — one of this ad account's `pages[].id` values from `GET /ad-accounts` (not the `FB_PAGE_…` channel id).dailyBudgetDaily budget as a string of digits in the ad account's minor currency units (e.g. `"5000"` = 50.00 USD). Exactly one of `dailyBudget` / `lifetimeBudget` is required.lifetimeBudgetLifetime budget as a string of digits in the ad account's minor currency units (e.g. `"50000"` = 500.00 USD). Lifetime-budget campaigns stop being deliverable 30 days after creation.pixelIdOptional Meta pixel id to attach — discover ids with `GET /ad-accounts/{adAccountId}/pixels`.adNameOptional ad name — defaults to the campaign name.adsetNameOptional ad-set name — defaults to the campaign name.

This sends a real POST to your live organization.

Enter your key and secret to send.

curl -X POST "https://example.com/ad-accounts/act_1234567890/campaigns" \  -H "Content-Type: application/json" \  -d '{    "name": "Summer push",    "pageId": "962527466952418",    "lifetimeBudget": "50000",    "adName": "Summer push ad",    "adsetName": "Summer push set"  }'

{  "campaignId": "string",  "name": "string",  "status": "ACTIVE",  "createdTime": "string",  "adId": "string",  "adName": "string",  "pixelId": "string",  "adset": {    "id": "string",    "name": "string",    "lifetimeBudget": "string",    "dailyBudget": "string",    "startTime": "string",    "endTime": "string"  },  "insights": {    "campaign_id": "120210000000000000",    "campaign_name": "Spring Sale — message campaign",    "marketing_messages_spend": "0.02",    "marketing_messages_delivered": "2",    "marketing_messages_cost_per_delivered": "0.01",    "marketing_messages_read_rate": "100",    "marketing_messages_link_btn_click": "0",    "marketing_messages_link_btn_click_rate": "0",    "marketing_messages_cost_per_link_btn_click": "0",    "date_start": "2026-05-20",    "date_stop": "2026-06-18"  }}

{  "message": "string"}

{  "message": "string"}

{  "message": "string"}

{  "error": [    {      "message": "string",      "path": [        "string"      ],      "type": "string",      "context": {}    }  ]}

Authorization

Path Parameters

Request Body

Response Body

201application/json

400application/json

402application/json

403application/json

422application/json

Try it

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`