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.
Authentication
authentication 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
Workspace the request operates in. Get it from List workspaces.
1 <= lengthOrganization 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.
1 <= lengthRequest 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"
}