Dynamo Developer DocsDynamo Developer Docs
External APIAd accounts

List Meta ad accounts

The org's connected Meta ad accounts, fetched live from the Meta Graph API using the org's system-user token. Returns `400` if the org is not connected to Meta Ads.

GET/ad-accounts

Authorization

x-api-key x-date x-signature
x-api-key<token>

Your API key (the ApiKeys document id).

In: header

x-date<token>

Current timestamp in ISO-8601 (must be fresh — within −5s..+60s of server time).

In: header

x-signature<token>

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

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/ad-accounts"
[  {    "id": "string",    "name": "string",    "currency": "string",    "businessCountryCode": "string",    "pages": [      {        "id": "string",        "name": "string"      }    ]  }]
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}

List message campaigns in an ad account

Message (CTM) campaigns in one ad account, fetched live from Meta and cursor-paginated. Echo a response's `nextCursor` back as `after` for the next page. Returns `400` if the org is not connected to Meta Ads.

Get per-day campaign insights

Per-day (time_increment=1) insights time series for one message campaign, fetched live from Meta. Optional `dateStart` / `dateEnd` (`YYYY-MM-DD`) window. Meta only serves daily insights for campaigns created on/after 2026-03-01; older campaigns return `400`. Also returns `400` if the org is not connected to Meta Ads.