Dynamo Developer DocsDynamo Developer Docs
External APICampaigns

Delete a marketing message campaign

Delete a marketing message campaign. The id is passed straight to Meta's delete — identical to the in-app delete, with **no reference checks**: deleting a campaign that an existing marketing message still points at is allowed (that message's sends will then fail). Pass the list item's top-level `campaignId` to remove the whole campaign.

delete/campaigns/{campaignId}

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

campaignId*string

The Meta campaign id.

Response Body

application/json

application/json

application/json

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

This sends a real DELETE to your live organization.

Enter your key and secret to send.

curl -X DELETE "https://example.com/campaigns/120210000000000000"
{  "success": true}
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}

Update a marketing message campaign

Update a marketing message campaign — rename it, pause / reactivate it, change its budget, or rename its ad / ad set. At least one of `name` / `status` / a budget field is required.

Get lifetime campaign insights

Lifetime summary insights for one marketing message campaign — spend, delivered, read rate, link-button clicks + costs, and offsite-conversion actions / values / ROAS. May return `null` when there are no insights; returns `400` if the org isn't connected to Meta Ads.