List Instagram posts to boost
Lists posts from the Instagram account a Meta ad connection can reach, so you can boost one as an ad.
An existing Instagram post can be boosted this way without connecting the Instagram account separately. Each posts[].id is the existing-post id to send as platformPostId when creating the ad; Meta turns it into source_instagram_media_id on the creative.
Identity resolution reuses the same resolver as /v1/ads/instagram-accounts. igUserId is always checked against the identities the connection can reach and is never trusted as sent.
Authentication
API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
Query parameters
Zernio Meta Ads, Facebook or Instagram SocialAccount ID.
Meta ad account ID including the act_ prefix. Narrows identity resolution to the Instagram accounts reachable from this ad account.
Instagram identity to list. Must be one this connection can reach, otherwise the request is rejected with a 400.
25Number of posts to return per page.
Opaque Meta cursor from a previous response's paging.after.
Responses
Success· the request worked
Errors· the request failed
How it behaves
When no identity is reachable
The endpoint fails instead of returning an empty list, and the two causes stay apart:
403 reconnect_required: the connection predates Instagram access, and the account must be reconnected granting Instagram access. Meta then omitsinstagram_business_accountfrom the Page read rather than erroring, so it looks identical to having no data.422 instagram_business_account_unresolved: the Page genuinely has no Instagram professional account linked.
List Instagram ad identities
Lists the Instagram accounts a Meta ad connection can run ads as, so you can pick the identity for a new ad. Discovers identities through connected_instagram_accounts, Page linkage and Page-backed identities, with a best-effort business fallback. Business permission errors do not fail discovery. The resolved object uses the same profile-scoped resolver as ad creation; null means no identity was resolved. Format-specific observed-actor fallbacks at creative creation are not predicted. Instagram accounts and Pages that other businesses share with the ad account's business as partner assets are listed with source business_partner, and Pages the ad account promotes with source promote_pages. These reads are best effort: a failure there never fails discovery.
List advertisable apps
Lists the mobile apps a Meta ad account can promote, with their platforms and store links, for app install campaigns. Lists applications available to a Meta ad account, their supported platforms and unmodified object store URLs. A listed app still needs a configured mobile platform and store URL to run install promotion.