Managing Permissions

Request access to dealership pages

Before you send vehicle listings to Facebook, you need to obtain permission from car dealerships to post on their behalf. Vehicle Listings on Marketplace are backed by Dealership Facebook Pages so that Messages are routed to the right place.

Listing used cars on Facebook Marketplace is currently a closed beta program. If you're a listing partner interested in joining the beta program, learn more or fill out this form.

Dealerships who want to list their used cars on Marketplace can sign up through one of our listing partners.


Prerequisites

  • Business Manager with at least 1 admin user
  • (For automation) Facebook App claimed under a business
  • (For automation) Business System Admin User

In order to make API requests (which requires business_management permission), you have to request an app review. Dev mode is allowed for some time/number of requests, but when your integration is in production, you should request an app review and switch the app to Live mode. An app in Dev mode could stop working as expected at any moment.

Find more info about app review in our FAQs.

Whitelisting an individual Dealership

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 Page Editor role to post on a page's behalf:


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

If you want to manage the dealer's leads form, you should select Page Admin role, more details refer to Retrieving Leads.


Bulk Whitelisting using the Graph API

We recommend spreading the graph API requests over time, and limit permissions requests to 100 / hour to avoid throttling.

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"
    If you are using Graph API V3.0 and below:
            curl \
            -F "page_id=<PAGE_ID>" \
            -F "permitted_roles=['CONTENT_CREATOR']" \
            -F "access_token=<ACCESS_TOKEN>" \
    "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"
  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 "tasks=['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
            -F "access_token=<ACCESS_TOKEN>" \
    "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"
    If you are using Graph API V3.0 and below:
            curl \
            -F "user=<BUSINESS_SCOPED_USER_ID>" \
            -F "role=CONTENT_CREATOR" \
            -F "access_token=<ACCESS_TOKEN>" \
    "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Dealer-side request

Once a request has been made to a Dealer, they will be able to respond on their page settings: