Instagram account-level permissioning

• Create partnership ads from a creator’s handle without a pre-existing post.
• Create partnership ads from any of a creator’s existing posts that tag your brand (Note: You must be tagged using the paid partnership label, an @ mention﹡, people tags﹡, product tags﹡, or Instagram Collabs﹡).
• Include or exclude a creator’s audience in the partnership ad campaign.

• Tag a brand partner in the paid partnership label when making branded content posts.

• instagram_branded_content_ads_brand
• instagram_basic
• business_management

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'creator_instagram_account=<CREATOR_IG_ID>' \
  # OR
  -F 'creator_instagram_username=<CREATOR_IG_USERNAME>' \
'https://graph.facebook.com/v26.0/<BUSINESS_ACCOUNT_ID>/branded_content_ad_permissions'

{
  "id": "<PERMISSION_ID>"
}

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  -d 'creator_username=<CREATOR_USERNAME>' \
'https://graph.facebook.com/v26.0/<BUSINESS_ACCOUNT_ID>/branded_content_ad_permissions'

{
  "data": [
    {
      "creator_username": "jaspersmarket",
      "creator_id": "123",
      "creator_fb_page": "123",
      "brand_ig_user": {
        "id": "1234"
      },
      "permission_status": "APPROVED", // Creator approval status: REVOKED, PENDING, etc.
      "id": "<PERMISSION_ID>"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MTM4OTY1MDkwNzkyMTE4NQ==",
      "after": "MTAyMzMxNzA5NzY5MjU4NA=="
    }
  }
}

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'creator_instagram_account=<CREATOR_IG_ID>' \
  -F 'revoke=true'
'https://graph.facebook.com/v26.0/<BUSINESS_ACCOUNT_ID>/branded_content_ad_permissions'

{
  "id": "<PERMISSION_ID>"
}

• Use batch operations — The POST endpoint accepts an array of actions, allowing you to process multiple permission changes in a single request. Prefer this over individual calls.
• Paginate large result sets — Use limit and offset when listing permissions. The maximum limit per request is 1,000.
• Filter early — Use status, partner_page_ids, and permission_direction query parameters to narrow results and reduce response size.
• Inspect per-item results — Batch POST responses include individual status fields. Always check each item for "success" or "failure", then detect and retry items that failed while keeping successful items.