Pages

Businesses can claim pages that belong to them. This enables administrators to easily assign people to pages they should have access to.

Claim Pages

To claim a page for your business as the OWNER, you need the page ID. Then, send a POST request:

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

The ig_password parameter is needed when the page is connected with Instagram.

To claim a page for your business as an AGENCY, you need the page ID. Then, send a POST request:

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

If you use AGENCY:

  • You must provide permitted_tasks.
  • The page needs to be owned by a Business.

To make this request you must use the access token of an Admin user or Admin system user of your business. If the user who makes the call is a Page Admin, or MANAGER, of the page for more than 7 days, the business immediately owns the Page. Facebook returns access_status in the response set to CONFIRMED. If someone becomes the Page Admin, or MANAGER, of the page in less than or equal to 7 days, we do not automatically approve the API request.

If the user who makes an OWNER claim call does not have the proper permissions on the Page, the call fails. Unlike claiming an ad account, no request is sent to the Page admins to be approved.

If you make an AGENCY claim, but do not have proper Page permissions, the response is PENDING. The Admin for that Page can log in and grant the access, deny it, or report the claim as a spam. If a business has too many Page access requests reported as spam, we lock the Business Manager.

To see all client pages you requested access to but are pending approval, make this GET call. You need the access token for the Admin system user:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

View Business-Owned Pages

To see all pages that your business owns, use this GET call:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/BUSINESS_ID/owned_pages"

The ig_password parameter is needed when the page is connected with Instagram.

To see all pages your business is an agency of, use this GET call:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/BUSINESS_ID/client_pages"

This returns a list of pages that belong to clients of a Business Manager.

Remove Pages

To remove a Page from the Business, make this DELETE call:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Add People to Pages

After your business has a Page, you can assign people tasks for it. Tasks include:

Name API Constant Description

Admin

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Can manage admin roles, send messages and post as the Page, create ads and view reports.

Editor

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Can edit the Page, send messages and post as the Page, create ads, and view reports.

Moderator

['MODERATE', 'ADVERTISE', 'ANALYZE']

Can respond to and delete comments on the Page, send messages as the Page, create ads, and view reports.

Advertiser

['ADVERTISE', 'ANALYZE']

Can create ads for the Page and view insights.

Analyst

['ANALYZE']

Can view reports.

You need:

  • page_id — ID of the Page
  • user_id — User ID to add
  • Tasks to assign

Make this POST call to add someone with the tasks ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/PAGE_ID/assigned_users"

Change Pages Access

To change an existing user's tasks, use the same POST call you do when you add a new user with tasks:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/PAGE_ID/assigned_users"

View Page Permissions

To see pages with user permissions, make this GET call:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/VERSION/BUSINESS_SCOPED_USER_ID/assigned_pages"

To see specific permissions on a Page, make this GET call:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/VERSION/PAGE_ID/assigned_users?business=<business_id>"

Remove Page Access

Before you can remove a page from Business Manager, you must also remove the admins of that page from your business.

To remove someone's access from an Page you own, you need

  • page_id — ID of the Page
  • user_id — ID of the user to remove

The DELETE call is:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/VERSION/PAGE_ID/assigned_users"