AdnovaDocs
Ad Launcher

Partnership identity ad

Publish your own creative under a second (partner) identity.

A partnership identity ad runs your own uploaded creative but publishes it under a second identity — a creator's or partner's Facebook Page / Instagram account — as a collaborative post.

This differs from a partnership code ad, which boosts a creator's existing post via a code and has no creative upload.

When to use this

You have a creative to run and a partner/creator has granted you permission to publish under their identity.

Example body

POST /meta/launches — set isPartnershipIdentityAds: true on the batch and secondIdentity on each ad.

Every key applicable to a partnership-identity ad, with sample values. Required: batch flag isPartnershipIdentityAds: true and per-ad secondIdentity, on top of the usual creative-ad requirements.

{
  "adAccountId": "01H8Y4...",
  "platform": "meta",
  "isPartnershipIdentityAds": true,
  "ads": [
    {
      "adName": "Creator Collab — Spring",
      "adSets": ["123456789012345"],
      "creativeDetails": {
        "groupType": "single_image",
        "creatives": [{ "_id": "01H8YA..." }]
      },
      "adProfiles": {
        "facebook_page_id": "123456789012345",
        "instagram_account_id": "987654321098765",
        "page_backed_instagram_account_id": null
      },
      "secondIdentity": {
        "facebook_page_id": "222333444555666",
        "instagram_account_id": "777888999000111",
        "page_backed_instagram_account_id": null
      },
      "identityDisplayFormat": "1",
      "testimonial": "Loved styling this spring drop! — @creator",
      "cta": "SHOP_NOW",
      "defaultPrimaryText": "In partnership with @creator.",
      "primaryTextVariations": ["A spring collab you'll love", "Styled by @creator"],
      "defaultHeadline": "Spring Sale",
      "headlineVariations": ["40% off", "New season"],
      "adDescription": "Free shipping on orders over $50.",
      "webLink": "https://example.com/spring",
      "displayLink": "example.com/spring",
      "utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=creator_collab",
      "leadGenFormId": null,
      "adSchedule": { "startDate": "2026-06-01T00:00:00Z", "endDate": "2026-06-30T23:59:59Z" },
      "promoCodeDetails": { "type": "manual", "manualCodes": ["SPRING40", "EARLYBIRD"] },
      "aiMediaDisclosure": true
    }
  ]
}

Full schema: Create a launch.

Required fields

Batch level:

  • isPartnershipIdentityAds: true

Per ad (it's a creative ad, so the creative-ad rules apply):

  • adName, adSets
  • creativeDetails.creatives[]._id
  • adProfiles — your primary identity (at least one of facebook_page_id / instagram_account_id)
  • cta, webLink
  • secondIdentity.facebook_page_id — the partner identity (required on every ad when the batch flag is set)

Missing secondIdentity on any ad is rejected (400). The server mints ads[].id and creativeDetails.groupId.

Optional fields

identityDisplayFormat, testimonial, and the usual copy/targeting optionals (defaultPrimaryText + variations, defaultHeadline + variations, adDescription, displayLink, utm, adSchedule, promoCodeDetails, leadGenFormId, aiMediaDisclosure).

Field notes

  • isPartnershipIdentityAds: true — batch-level flag that enables this mode.
  • secondIdentity — the partner identity the ad co-publishes under.
  • adProfiles — your primary publishing identity; secondIdentity is the partner.
  • identityDisplayFormat — optional. How the two identities are shown: "1" both in the header, "2" first only, "3" dynamic. Any other value is rejected (400).
  • testimonial — optional partnership presentation text.

Gotchas

  • The partner must first grant your business the relevant branded-content / partnership permissions in Meta, or the launch is rejected.
  • Every ad in the batch needs secondIdentity when the flag is set.