MAmadethis
Ads

Create and launch a Meta campaign (async; spend-policy gated)

post/ads/publish

Request

  • Base URL
    https://api.madethis.com/v1
  • URL
    https://api.madethis.com/v1/ads/publish
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Unique per intent, 1–128 printable ASCII characters. Reuse the SAME value on a retry: the request replays instead of running twice.

Request body

creativeStorageIdstring required
headlinestring required
primaryTextstring required
ctaType'LEARN_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'WATCH_MORE' | 'GET_OFFER' required
audienceDescriptionstring required
dailyBudgetCentsinteger required

Response

Success envelope. Or, when the business's spend policy parks the call: Parked by the business's spend policy (kind: ad_publish). NOTHING has been spent, published or sent. Confirm with POST /v1/confirmations/{id}/confirm — or reject it — before the expiry; the original call is replayed exactly once.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.