Post-Level Permissioning

Post-level permissioning allows you to add, remove, and check creators on your list of those approved to tag your brand in the paid partnership label on branded content posts. It also allows creators to give you permission to promote their organic branded content posts as partnership ads.

The general flow for enabling post-level permissions is:

1. See which creators are approved to tag your brand in the paid partnership label on branded content posts.
2. Add creator user IDs to the approved tagging list.
3. Remove creator user IDs from the approved tagging list.
4. Creators can check who they have given permission to promote a given organic post as a partnership ad.
5. Creators can give you permission to promote the given organic post as a partnership ad.

Permissions

In order to use post-level permissioning, you must have a Facebook User access token with the following:

• instagram_basic
• instagram_branded_content_brand (for the /branded_content_tag_approval endpoint)
• instagram_branded_content_creator (for the /branded_content_partner_promote endpoint)
• Advanced Access

Approved Creators

You have the option to restrict who can tag your brand in the paid partnership label on branded content posts. When restrictions are turned on, you can allow users to tag your brand in branded content posts by adding them to your approved creator list.

The /{user-id}/branded_content_tag_approval endpoint allows you to add, remove, and view the creators on your approved accounts list, if approval is required.

Verify if creators are approved

Use a GET call to the /{user-id}/branded_content_tag_approval endpoint to verify if creators are on the approval list.

Example request

curl -G \
  -d 'user_ids=<USER_ID1, USER_ID2, ...>' // list of creator user IDs
  -d 'access_token=<BUSINESS_ACCESS_TOKEN>'
'https://graph.facebook.com/v25.0/<USER_ID>/branded_content_tag_approval'

Parameters

Example response

If successful, a list of approved creators is returned, filtered by the user IDs provided.

{
 "data": [
  {
    "id": "<USER_ID>"
  }
 ]
}

Update the creator approval list

Use a POST call to the /{user-id}/branded_content_tag_approval endpoint to add creators to the approval list.

Example request

curl -X \
  -d 'user_ids=<USER_ID5, USER_ID10, USER_ID15, ...>' // list of creator user IDs
  -d 'access_token=<BUSINESS_ACCESS_TOKEN>'
'https://graph.facebook.com/v25.0/<USER_ID>/branded_content_tag_approval'

Parameters

Example response

{
  "success": true 
}

Note: A false value is returned if one or more of the user IDs failed to update, in which case, no user IDs will be added to the approval list.

Delete creators from the approval list

Use a DELETE call to the /{user-id}/branded_content_tag_approval endpoint to remove user IDs from the approval list.

Example request

curl -X DELETE\
  -d 'user_ids=<USER_ID3, USER_ID5, ...>' // list of creator user IDs
  -d 'access_token=<BUSINESS_ACCESS_TOKEN>'
'https://graph.facebook.com/v25.0/<USER_ID>/branded_content_tag_approval'

Parameters

Example response

{
  "success": true 
}

Note: A false value is returned if one or more of the user IDs failed to be deleted, in which case, no user IDs will be deleted from the approval list.

Allow Branded Content Post to be Boosted

A creator must give permission to a brand to use individual posts as partnership ads.

Check brand partnership status

The /{ig-media-id}/branded_content_partner_promote endpoint call allows a creator to get the list of brands that are approved to promote a given branded content post.

Example request

curl -G \
  -d  'access_token=<CREATOR_ACCESS_TOKEN>'
'https://graph.facebook.com/v25.0/<IG_MEDIA_ID>/branded_content_partner_promote'

Example response

{
  "approved": <BUSINESS_ACCOUNT_ID1, BUSINESS_ACCOUNT_ID2, ...> // list of business account IDs
}

If successful, a comma-separated list of approved business account IDs is returned.

Allow brand partnerships

The {ig-media-id}/branded_content_partner_promote endpoint allows a creator to activate the Allow brand partner to boost setting without the Instagram app.

Note: Creators will need to create their post and tag the brand partner via the Instagram platform.

Example request

curl -X \ POST
  -d  'sponsor_id=<BUSINESS_ACCOUNT_ID>' // Business account ID for which the creator is granting, or revoking, promotion permissions
  -d  'permission=true | false'
  -d  'access_token=<CREATOR_ACCESS_TOKEN>'
'https://graph.facebook.com/v25.0/<IG_MEDIA_ID>/branded_content_partner_promote'

Parameters

Example response

{
  "success": true 
}

Note: A false value is returned if there is an error, and permission will not be granted to the brand partner.

Learn More

• IG User
• IG Media
• Branded Content Policy
• Ad Policy