AdnovaDocs
Ad Launcher

List drafts

Drafts saved against an ad account, newest modified first, including drafts created in the Adnova dashboard. Launched and deleted drafts are excluded. Paginate with skip / limit.

GET
/meta/ad-accounts/{adAccountId}/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

Path Parameters

adAccountId*string

Adnova internal ad-account id from List ad accounts.

Length1 <= length

Query Parameters

skip?integer

Number of drafts to skip. Defaults to 0.

Default0
Range0 <= value
limit?integer

Page size. Defaults to and is capped at 250.

Default250
Range1 <= value <= 250

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/ad-accounts/string/drafts" \  -H "x-workspace-id: string" \  -H "x-org-id: string"
{
  "data": [
    {
      "_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"
    }
  ],
  "total": 12
}
{
  "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"
}