AdnovaDocs
Ad Launcher

Create a draft

Save a launch without launching it. A draft is the review step for programmatic launches: compose it here in full, have a person check it in the Adnova dashboard, then launch it. Nothing reaches Meta and nothing spends until then. Drafts are stored as sent — unlike Create a launch, the payload is not checked against ad sets, and the per-ad fields a launch requires may be left out. To launch a draft, call Create a launch with the complete payload plus its draftId; the draft is removed once the batch is created. orgId is taken from the x-org-id header and platform is always meta; sending either in the body is a 400. Uses the **General** rate-limit bucket, not the Launch bucket.

POST
/meta/drafts

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint). For lookup endpoints the org is derived from the ad account in the URL, so any org id you have access to is accepted.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/ad-launcher/v1/meta/drafts" \  -H "x-workspace-id: string" \  -H "x-org-id: string" \  -H "Content-Type: application/json" \  -d '{    "adAccountId": "01H8Y4...",    "draftName": "Spring Sale — hero carousel",    "ads": [      {        "adName": "Hero Carousel — Spring Sale",        "adSets": [          "123456789012345"        ],        "creativeDetails": {          "groupType": "carousel",          "creatives": [            {              "_id": "01H8YA...",              "cardTitle": "Spring Sale — 40% Off",              "webLink": "https://example.com/spring-sale"            }          ]        },        "adProfiles": {          "facebook_page_id": "123456789012345",          "instagram_account_id": "987654321098765"        },        "cta": "SHOP_NOW",        "defaultPrimaryText": "Big sale this spring — up to 40% off",        "webLink": "https://example.com/spring-sale"      }    ]  }'
{
  "draftId": "01H8YC..."
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}