AdnovaDocs
Ad Launcher

List Instagram partnerships

Instagram creators who have granted branded-content ad permission to this Instagram account. Used as the secondIdentity when launching partnership ads.

GET
/meta/partnerships/instagram/{instagramAccountId}

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Path Parameters

instagramAccountId*string

Brand Instagram account the permissions were granted to. Get this from List ad profiles.

Length1 <= length

Query Parameters

refetch?string

true fetches from Meta and refreshes the cache. Omitted or false serves the cached copy.

Value in"true" | "false"

Header Parameters

x-workspace-id*string

Workspace the request operates in. Get it from List workspaces.

Length1 <= length
x-org-id*string

Organization context (required on every endpoint). For lookup endpoints the org is derived from the ad account in the URL, so any org id you have access to is accepted.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/ad-launcher/v1/meta/partnerships/instagram/string" \  -H "x-workspace-id: string" \  -H "x-org-id: string"
{
  "data": [
    {
      "creator_fb_page_id": "123456789012345",
      "creator_ig_id": "987654321098765",
      "creator_username": "creator.handle",
      "brand_ig_id": "17841400000000000",
      "brand_username": "brand.handle",
      "permission_status": "APPROVED",
      "permission_type": "ADS_WITH_BRANDED_CONTENT"
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}