Managing Permissions

Business Manager (BM) and access to Dealer pages

Before you send vehicle listings to Facebook, your Business Manager has to obtain permission access to Facebook dealers pages to post on their behalf.

• Your company people can be admin/ Business Manager should have at least 1 admin user
• We recommend to create a Business System Admin User

Note that:

Standard Access permission with Publish content role is required to list on Marketplace and receive Messenger Chat based leads and Lead forms to download manually.

while:

Admin Access permission with Manage Page role is required to retrieve leads via API, and this gives access to listing on Marketplace and receiving Messenger Chat based leads and Lead forms too.

Standard Access to Dealer pages via BM

To request and obtain Standard Access from your Business Manager, go to Accounts > Pages. Click the button and select Request Access to Page in the dropdown.

Enter the name or URL of the Facebook page:

Select Publish content role:

Finally, once a Dealership has approved the request, assign a person from your team a Page Editor role:

Admin access to Dealer pages via BM

To request and obtain Admin Access from your Business Manager, follow the same steps as per Standard Access to Dealer pages go to Accounts > Pages, click the button and select Request Access to Page in the dropdown, enter the name or URL of the Facebook page, but make sure to select Manage Page role:

Finally, once a Dealership has approved the request, assign a person from your team a Page Editor role.

By default, only Page admins with Manage page role can access the leads. If you want to give access to dealers you can enable the customized access to leads. In this case, please make sure the dealer grant your business manager access to the leads.

Requesting access via Graph API

In order to request permissions to multiple Facebook pages in bulk, use the Business Manager API to make multiple requests.

1. Set up a Facebook app (https://developers.facebook.com/docs/apps/register) and claim it under your business: Business Manager > Accounts > Apps
2. Set up a Business System Admin User: Business Manager > Users > System Users
3. Generate a new token and save it. It will not be displayed again, so be sure to save it right away.
4. Use the generated token to make API calls to request Page Editor (“CONTENT_CREATOR”) permissions from dealers. Ex:
   If you are using Graph API V3.1 and above:

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

   At this point, you will have to wait that other page approves the request (they can do it under their business manager, under “Requests”, or directly from their page settings.)
   After the dealer's page approves the request, you will be able to make the call in the next step, otherwise you'll get an error.
5. Grant a person from your team a CONTENT_CREATOR role for that particular page. You can get the Business Scoped User ID from the “People” section of your Business Manager:
   If you are using Graph API V3.1 and above:

   curl \
     -F "user=<BUSINESS_SCOPED_USER_ID>" \
     -F "permitted_tasks=['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
     -F "access_token=<ACCESS_TOKEN>" \
     "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

   Note: if the page still didn’t accept your request made in the step 4, you will get the error: “You do not have permission to perform this action. This action requires that you can MANAGE_PERMISSIONS on a managing business account. Or it requires that you can ADMINISTER on this object Note: to use do this action on behalf of a business account the "business" field must be set.”
   
   If you want to request Admin Access instead of just Content Creator, you should perform the request via API by adding `MANAGE` task in `permitted_tasks` as following:

   curl \
     -F "page_id=<PAGE_ID>" \
     -F "permitted_tasks=['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE', 'MANAGE']" \
     -F "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN >" \
     "https://graph.facebook.com/v3.2/<BUSINESS_ID>/client_pages"

Dealer-side request

Once a request has been made to a Dealer, they will be able to respond from their Page Settings: