---
title: "List Instagram ad identities"
method: GET
path: "/v1/ads/instagram-accounts"
tags: ["Ad Accounts"]
---

# List Instagram ad identities

`GET /v1/ads/instagram-accounts`

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.

## Query parameters

- `accountId` string, required
- `adAccountId` string, required

## Response `200`

Instagram identities and Page linkage.

- object
  - `accounts` object[], required
    - `igUserId` string, required — Instagram identity ID.
    - `username` string, required — Instagram username; empty when Meta does not expose it.
    - `profilePictureUrl` string — Profile picture URL when available.
    - `isPageBacked` boolean, required — Whether this is a Page-backed Instagram identity.
    - `source` 'ad_account' | 'page_backed' | 'business', required — Discovery source; Page linkage also uses page_backed.
  - `pages` object[], required
    - `pageId` string, required — Facebook Page ID.
    - `name` string, required — Facebook Page name.
    - `instagramBusinessAccount` MetaInstagramIdentityRef
      - `igUserId` string, required — Instagram identity ID.
      - `username` string, required — Instagram username; empty when Meta does not expose it.
      - `profilePictureUrl` string — Profile picture URL when available.
    - `connectedInstagramAccount` MetaInstagramIdentityRef
      - `igUserId` string, required — Instagram identity ID.
      - `username` string, required — Instagram username; empty when Meta does not expose it.
      - `profilePictureUrl` string — Profile picture URL when available.
  - `resolved` object, required
    - `pageId` string, nullable, required — Page selected by the shared ad-creation resolver.
    - `igUserId` string, nullable, required — Instagram identity selected by the shared ad-creation resolver.
    - `source` 'ad_account' | 'page_backed' | 'business' | 'null', nullable, required — Discovery source of the resolved identity; null when absent from discovery.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The account or Meta asset is not accessible.
- `404` — The account or requested resource was not found or is not accessible. An account ID may have been disconnected and removed. Read GET /v1/accounts for current account IDs.
- `409` — The account exists but is inactive or needs reconnection. Reconnect it, then read GET /v1/accounts for its current account ID before retrying. Code: ads_connection_required.
- `501` — Only supported on Meta Ads and Facebook accounts.

## Changes

- **2026-09-25** `2c04683ce694` — 12 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/adAccountId` to the response with the `404` status
  - added the optional property `details/adAccountId` to the response with the `409` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - …8 more
- **2026-09-16** `3e6ddf2a99ea` — 3 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `404` status
  - added the optional property `details/budgetScope` to the response with the `409` status
- **2026-09-15** `0dba7d004d75` — 6 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `404` status
  - added the optional property `details/quotaExhausted` to the response with the `409` status
  - added the optional property `details/quotaScope` to the response with the `400` status
  - …2 more
- …earlier changes not shown

[Full history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/instagram-accounts/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/e0122970214f?raw)