Ad Launcher
Get draft
Returns a draft with its creatives' file details resolved. Answers 404 for a draft that was launched or deleted, or that belongs to another organization.
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
Path Parameters
draftId*string
Draft id from Create a draft or List drafts.
Length
1 <= lengthHeader Parameters
x-workspace-id*string
Workspace the request operates in. Get it from List workspaces.
Length
1 <= lengthx-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.
Length
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/drafts/string" \ -H "x-workspace-id: string" \ -H "x-org-id: string"{
"_id": "01H8YC...",
"draftName": "Spring Sale — hero carousel",
"adAccountId": "01H8Y4...",
"accountId": "1234567890",
"platform": "meta",
"orgId": "string",
"isPartnershipIdentityAds": true,
"ads": [
{
"adName": "Hero Carousel — Spring Sale",
"adSets": [
"123456789012345"
],
"creativeDetails": {
"groupType": "carousel",
"creatives": [
{
"_id": "01H8YA...",
"cardTitle": "string",
"cardDescription": "string",
"webLink": "string",
"productHeadline": "string",
"productDescription": "string",
"customThumbnail": {
"_id": "01H8YT..."
},
"carouselPortrait": {
"_id": "01H8YP..."
}
}
]
},
"adProfiles": {
"facebook_page_id": "123456789012345",
"instagram_account_id": "987654321098765",
"page_backed_instagram_account_id": "string"
},
"cta": "SHOP_NOW",
"defaultPrimaryText": "string",
"primaryTextVariations": [
"string"
],
"defaultHeadline": "string",
"headlineVariations": [
"string"
],
"adDescription": "string",
"defaultLanguage": 6,
"languages": [
{
"locale": 5,
"primaryText": "string",
"headline": "string",
"description": "string",
"webLink": "string",
"displayLink": "string",
"creative": {
"_id": "01H8YA...",
"versionId": "string"
}
}
],
"webLink": "string",
"displayLink": "string",
"utm": "string",
"productSetData": {
"business_id": "string",
"catalog_id": "string",
"product_set_id": "string"
},
"productSetId": "string",
"leadGenFormId": "string",
"adSchedule": {
"startDate": "2026-06-01T00:00:00Z",
"endDate": "2026-06-30T23:59:59Z"
},
"promoCodeDetails": {
"type": "manual",
"manualCodes": [
"SPRING40",
"EARLYBIRD"
]
},
"usePageActorOverride": true,
"appCustomProductPage": "1234567890",
"aiMediaDisclosure": true,
"adId": "120210000000000000",
"hasCreativeEdits": true,
"preferCreativeId": true,
"organicPostDetails": {
"postId": "123456789_987654321",
"sourceType": "facebook",
"mediaType": "string"
},
"secondIdentity": {
"facebook_page_id": "string",
"instagram_account_id": "string",
"page_backed_instagram_account_id": "string"
},
"identityDisplayFormat": "1",
"testimonial": "string"
}
],
"viewType": "table",
"gridFormData": {},
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"modifiedAt": "2019-08-24T14:15:22Z",
"modifiedBy": "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"
}{
"error": {
"code": "string",
"message": "string"
},
"message": "string"
}