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,adSetscreativeDetails.creatives[]._idadProfiles— your primary identity (at least one offacebook_page_id/instagram_account_id)cta,webLinksecondIdentity.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;secondIdentityis 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
secondIdentitywhen the flag is set.
