Ad Accounts

List Instagram posts to boost

Changed on Nov 10, 2026

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.

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 omits instagram_business_account from 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.

get/v1/ads/instagram-posts

Request

Base URL
https://zernio.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/zernio/apis/zernio-api/docs/v1/ads/instagram-posts/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

accountIdstring required

Zernio Meta Ads, Facebook or Instagram SocialAccount ID.

adAccountIdstring

Meta ad account ID including the act_ prefix. Narrows identity resolution to the Instagram accounts reachable from this ad account.

igUserIdstring

Instagram identity to list. Must be one this connection can reach, otherwise the request is rejected with a 400.

limitinteger

Number of posts to return per page.

afterstring

Opaque Meta cursor from a previous response's paging.after.

Response

Instagram posts available to boost.

igUserIdstring required

Instagram identity the posts belong to.

usernamestring required

Instagram username; empty when Meta does not expose it.

Changes

Nov 10, 2026d568bb00ed73 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 6, 2026f8c8f34fb41a Revision changes
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status
- warning
  added the new account enum value to the / response property for the response status

Operation history (6 revisions)