AdnovaDocs
Ad Launcher

Create a partnership-code launch

Launch partnership (branded-content) ads that boost an existing creator post via a partnership ad code. There is no creative upload — each ad carries partnershipAdCode + the creator's secondIdentity. This is a separate endpoint from Create a launch because partnership-code ads are processed by a different internal pipeline. It is otherwise identical in behaviour: async (returns a batchId), the same stricter rate-limit bucket, and the same Idempotency-Key support. For partnership ads that publish your *own* creative under a second identity (not a code-boosted creator post), use the standard endpoint with isPartnershipIdentityAds: true instead — see Partnership identity ad. Ad set checks also apply: every referenced ad set must exist in the account, a regulated-location ad set must be selected alone, and all selected ad sets must share the same conversion location — otherwise 400. See Ad set compatibility.

POST
/meta/launches/partnership-code

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
Idempotency-Key?string

Optional. Any string ≤64 chars. Retries with the same key return the original response for 24h.

Lengthlength <= 64

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/launches/partnership-code" \  -H "x-workspace-id: string" \  -H "x-org-id: string" \  -H "Content-Type: application/json" \  -d '{    "adAccountId": "01H8Y4...",    "platform": "meta",    "ads": [      {        "adName": "Creator Collab — Spring",        "adSets": [          "123456789012345"        ],        "partnershipAdCode": "IGAAxxxxxxxxxxxx",        "secondIdentity": {          "facebook_page_id": "123456789012345",          "instagram_account_id": "987654321098765",          "page_backed_instagram_account_id": null        },        "identityDisplayFormat": "1",        "testimonial": "Loved this collab! — @creator",        "cta": "SHOP_NOW",        "webLink": "https://example.com/spring-sale",        "utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=creator_collab"      }    ]  }'
{
  "batchId": "01H8YB...",
  "status": "pending",
  "retryAfterSeconds": 10
}
{
  "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"
}