Instagram — Feature request: Paid Partnership label (is_paid_partnership / branded_content_sponsor_ids) on post creation
Ask
Expose Meta's Instagram branded-content disclosure parameters as Instagram platformSpecificData fields on post creation, so a sponsored post publishes already carrying its native Paid Partnership label.
Proposed shape, following your existing naming conventions:
instagram.isPaidPartnership (boolean) — applies the label without naming a brand
instagram.brandedContentSponsorIds (array, up to 4 Instagram user IDs) — tags brand partners, rendering "Paid partnership with @brand”
Scope: organic publishing only — feed photos, carousels, Reels, and Stories. Not partnership ads, not boosting.
Why
Instagram's Commercial Content Policy requires branded content to be disclosed with the native Paid Partnership label. Caption text (#ad, "Paid partnership with @brand") is not the native label and does not satisfy the policy on its own. With no API field, every sponsored post published through Zernio needs the label toggled by hand in the Instagram app after publishing, which is precisely the manual step an API-driven pipeline exists to eliminate.
It breaks unattended scheduling specifically. The toggle can only happen after the post is live, so any sponsored post going out on a queue slot or a scheduled time is non-compliant for however long it takes a human to notice and fix it. Scheduled sponsored content (the highest-value case for an API) becomes the one case that can't run unattended.
The label is now a ranking signal rather than a reach penalty. Meta's guidance changed on this; labeled paid partnerships are no longer suppressed. Posts missing the label during the manual gap forfeit that upside rather than avoiding a cost.
Instagram is the gap in an otherwise-covered surface. TikTok already has commercialContentType (none / brand_organic / brand_content) in your platform-specific data. Instagram is where branded content is most common and is the one place the disclosure can't be set through the API.
Meta API level
Meta shipped this on 22 April 2026 (Instagram Platform changelog, "Partnership Ads Label"). Two parameters were added to POST /<IG_USER_ID>/media:
POST /<IG_USER_ID>/media ?is_paid_partnership=true &branded_content_sponsor_ids=<IG_USER_ID>[,<IG_USER_ID>]
is_paid_partnership; enables the label with or without naming specific brands
branded_content_sponsor_ids; tags up to 2 brand partners
Supported on photos, Reels, carousels, and Stories. Partner IDs resolve through the Business Discovery API, so a username-in / ID-out helper (mirroring resolve_linkedin_mention) would give parity with how collaborators already works, if you want it.
Meta's stated intent for the change is this exact workflow; it "eliminates manual label application after publishing" for third-party publishing tools.
Permission requirements should be confirmed against Meta's current docs; we haven't verified whether your existing content-publish permission covers these parameters or whether a branded-content permission needs adding to the app's Advanced Access set.
Product asks
isPaidPartnership and brandedContentSponsorIds accepted in Instagram platformSpecificData on post creation and update, across all four content types including Stories.
Validation with a clear error rather than a silent drop. An unknown-key no-op is the dangerous failure mode: the post publishes successfully, simply isn't compliant, and nothing in the response indicates it.
Readback — surface the applied label on post retrieval and in external post metadata alongside isAiGenerated and mediaProductType, so compliance can be verified after the fact.
Docs — the Instagram platform guide's limitations section doesn't currently mention branded content either way. Stating it explicitly would help; the current silence reads as undocumented rather than unsupported.
References
Instagram Platform changelog, 22 Apr 2026 — Partnership Ads Label: https://developers.facebook.com/docs/instagram-platform/changelog
Content Publishing API: https://developers.facebook.com/docs/instagram-platform/content-publishing
Business Discovery API (partner ID lookup): https://developers.facebook.com/docs/instagram-platform/business-discovery
Log in to comment and vote
Comments2
Miquel Palet López
Sep 3
Shipped. isPaidPartnership and brandedContentSponsors are live on post creation.
Four places we landed differently from your spec:
Sponsors cap at 2, not 4. That is Meta's own limit on branded_content_sponsor_ids, the same number you quoted from their changelog.
The field takes usernames or numeric IDs. We resolve usernames through Business Discovery at publish time, so the brand has to be a public professional account. That is the username-in, ID-out helper you suggested, and it matches how collaborators already works.
No Stories. Meta documents these parameters for images and videos, and Stories reject them, so we reject Stories at creation with a 400 rather than let a post go out unlabelled.
Facebook Login only. Meta scopes the feature to the Instagram API with Facebook Login, so an account connected with Instagram Login gets a 400 with code instagram_paid_partnership_requires_facebook_login and needs reconnecting through the Facebook option. No new permission was needed, instagram_basic already covers it.
On your other asks: validation is explicit, so an unresolvable sponsor fails the post and names it rather than dropping the field. Readback echoes what you sent, because Instagram does not return the label or the sponsors when you read a post back. The Instagram platform guide now documents all of it.
One behaviour worth knowing: a brand that has already approved you as a creator shows "Paid partnership with @brand" immediately. Otherwise the post publishes with the plain label and the brand receives an approval request.
We also added commentsEnabled and locationId for Instagram in the same release.
Docs: https://docs.zernio.com/platforms/instagram
Rikk Woolls
Sep 5
Wow! BOSS. Thank you so much!!!