Less than 3 months ago, we publicly launched self service ads on Instagram and have seen great success since then.
To create ads on Instagram, or on both Facebook and Instagram, you need to have an Instagram account ID, which would be set as instagram_actor_id
in your ad creative. There are now three ways to get it:
We recommend the first solution, to leverage Business Manager to manage your Instagram accounts, while the other two choices may be useful for certain customers.
All those approaches are explained in detail in our Instagram Account Setup doc. Here are a few sample API calls:
To claim an Instagram account to a Business Manager: use Business Manager interface.
To get the Instagram account IDs owned by a business:
curl -G \ -d "access_token=<ACCESS_TOKEN>" \ -d "fields=username,profile_pic" \ "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/instagram_accounts"
To add an agency business to an Instagram account:
curl \ -F "access_token=<ACCESS_TOKEN>"\ -F "business=<BUSINESS_ID>"\ "https://graph.facebook.com/<API_VERSION>/<INSTAGRAM_ACCOUNT_ID>/agencies"
To assign an ad account to an Instagram account:
curl \ -F "access_token=<ACCESS_TOKEN>"\ -F "business=<BUSINESS_ID>"\ -F "account_id=<AD_ACCOUNT_ID>"\ "https://graph.facebook.com/<API_VERSION>/<INSTAGRAM_ACCOUNT_ID>/authorized_adaccounts"
To connect an Instagram account to a Page: use Page interface.
To get the Instagram account ID connected to a Page:
curl -G \ -d "access_token=<ACCESS_TOKEN>"\ -d "fields=username,profile_pic" \ "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/instagram_accounts"
To get the PBIA of a Page:
curl -G \ -d "access_token=<ACCESS_TOKEN>"\ -d "fields=username,profile_pic" \ "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/page_backed_instagram_accounts"
To create the PBIA of a Page:
curl \ -F "access_token=<ACCESS_TOKEN>"\ "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/page_backed_instagram_accounts"