Dynamo Developer DocsDynamo Developer Docs
External APIAd accounts

List marketing message campaigns in an ad account

Marketing message campaigns in one ad account, cursor-paginated — echo a response's `nextCursor` back as `after` for the next page. Returns `400` if the org isn't connected to Meta Ads.

get/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.

Query Parameters

after?string

Opaque Meta page cursor — a previous response's nextCursor.

Response Body

application/json

application/json

application/json

application/json

application/json

Try it

read-only

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

Path

Query

Enter your key and secret to send.

curl -X GET "https://example.com/ad-accounts/act_1234567890/campaigns"
{  "items": [    {      "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"      }    }  ],  "returned": 0,  "mayHaveMore": true,  "nextCursor": "string"}
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}
{  "error": [    {      "message": "string",      "path": [        "string"      ],      "type": "string",      "context": {}    }  ]}

List Meta ad accounts

The org's connected Meta ad accounts. Returns `400` if the org isn't connected to Meta Ads.

List an ad account's pixels

The ad account's Meta (Facebook) pixels — for discovering the optional `pixelId` a campaign create can attach. Read-only by design: pixels are created and managed in Meta, not through this API.