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.
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 <= lengthOptional. Any string ≤64 chars. Retries with the same key return the original response for 24h.
length <= 64Request 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"
}