Dynamo Developer DocsDynamo Developer Docs
External APICampaigns

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.

GET/campaigns/{campaignId}/daily-insights

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

Path Parameters

campaignId*string

The Meta campaign id.

Query Parameters

dateStart?string

Window start (YYYY-MM-DD).

dateEnd?string

Window end (YYYY-MM-DD).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/campaigns/string/daily-insights"
[  {}]
{  "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, 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 lifetime campaign insights

Lifetime summary insights for one message campaign (spend, delivered, read rate, link-button clicks + costs, and offsite-conversion actions / values / ROAS), fetched live from Meta. `campaignId` is the Meta campaign id from a campaign's `campaignId` field. Returns `400` if the org is not connected to Meta Ads. May return `null` when Meta has no insights for the campaign.