FAQs - Troubleshooting Tips

Frequently asked questions about Marketplace Vehicles.

General Questions

In the "Partner model" integration the page linked to the listings (see fb_page_id field in feed upload) is used to pull some information about you, such as name, logo and number of likes. It will be shown in the vehicle detail page of the listing.

If you are implementing a "Dealer model" integration, every listing will still have a page linked, and if you have the right permissions granted, the dealership information taken from their professional page will be shown.

Marketplace Vehicles allows two models, chat and lead form. The first one uses Facebook Messenger, and you'll receive user messages directly in the page linked to the listings (specified in fb_page_id field in the feed. The second model shows to the user a form similar to the following one:

The leads are received by the page linked to the listings. They can be accessed via webhook or Leads APIs, more information here.

Please notice that for both models you should have set the right page permissions.

You can choose which model you want to use by setting the value of dealer_communication_channel field in your feed.

Yes, just go to your page, you must be admin. Then click on Publishing Tools in the top header bar:

From the Publishing Tools page, click on "Forms Library" under the section "Lead Ads Form", on the left hand side. In the Forms Library table, you will find a form called "Marketplace Autos Lead Gen Form":

by clicking "Download", a dialog will appear, asking if you want to download new leads or leads within a specific time range. After selecting your preference, you will be able to download leads in CSV or XLS format.

The main criterion used is to maximize the possibility that the user that performed the search would convert to a lead. This means that the search result ranking is customized per user, so different users could see different results.

Once your inventory is integrated, your vehicle catalog is automatically usable for automotive inventory ads. Please note that in addition to catalog, automotive inventory ads also requires you to set up your Facebook Pixel or SDK on your website or app.

With automotive inventory ads, you’ll be able to promote your most relevant vehicle to your website/app visitors or reach new in-market shoppers. Learn more about automotive inventory ads here.

Business Verification and App Review

Companies working with user data require verification. You need business verification if you are using Facebook APIs to:

  • request permissions (Page Editor or Page Admin) to third party pages, e.g. to publish on behalf of dealership pages;
  • read/manage chat of third party pages;
  • read/manage leads of third party pages.
  • To use Facebook APIs you must have an app. Hence, to start a business verification, you must have an app associated to your business. You can associate an app to your business from your Business Settings > Accounts > Apps section:

    After adding your app here, you will be able to start your business verification from the Business Settings > Business Info:

    Please notice that verification documents will be sent to the business owner's email address.

    You can find more info on business verification here: https://www.facebook.com/business/help/2058515294227817.

    The criteria to determine if you need an App Review are the same for the verified business. You need an App Review to:

  • Request permissions (Page Editor or Page Admin) to third-party pages; for example, to publish on behalf of dealership pages
  • Read/manage chat of third-party pages
  • Read/manage leads of third-party pages
  • Start an App Review: From your app dashboard, clicking

    App Review

    . You can access all your apps from https://developers.facebook.com/apps.

    The permissions that you need are business_management, manage_page, page_messaging (in case of chat integration), leads_retrival (in case of lead form integration).

    You will be prompted to post a screencast

    Your app is likely to be code: In the screencast, you can show the portions of code related to the calls you want to make. You don't need a long recording; just be sure to cover the most sensitive areas, especially where user data is accessed and manipulated.

    You will be also prompted to explain how you are going to use the data you're requesting access to

    A good explanation example is:

    "We are [COMPANY], a Marketplace Motors partner. We offer [SERVICE (e.g. publish feed on marketplace)] to our clients, and we are requesting an app review to access [DATA (e.g. leads)] for [PURPOSE (e.g. redirect them the dealerships, our clients)]"

    In case of issues during the process you will receive an explanation of what's missing; anyway, by following these guidelines, your review should be generally quickly granted.

    Learn more about App Review.


    1. go to https://developers.facebook.com/tools/explorer/ with a developer account. The account must have admin access to the catalog.
    2. request a token with ads_management permissions.
    3. make a GET call to /{PRODUCT_FEED_ID}/uploads. Here you can retrieve the id of your last upload session (the topmost one)
    4. make a POST call to /{UPLOAD_SESSION_ID}/error_report
    5. make a GET call to /{UPLOAD_SESSION_ID}?fields=error_report

    In case the report is not ready, repeat the last call after a few seconds. Otherwise you should find a URL that you can download (e.g with wget, curl, etc.). The downloaded file will contain the full error report.

    If you want to automate this flow, you can use an app.

    If you get the error: "Cannot access an object not managed by the business owning this app", please make sure that the app you're using belongs to the business (Business Settings > Account > Apps).

    We suggest you to update the catalog daily. You should schedule the feed upload in replace mode, so that every day Facebook will read the whole feed again, updating listings with changes, adding the new ones, skipping the non updated ones and removing the deleted ones.

    Description is a field limited to 5000 characters. It's crucial to ensure a high quality listing, and it should be used to add all the useful information about the listing. HTML is not supported, but you can use new line (\n) characters to better structure your description.

    A listing with good image quality converts better. To be on marketplace, listings should have two or more images (up to 20), and they should show the actual vehicle. Images with banners, text or placeholder images are generally not allowed, and may be banned.

    Learn more on Marketplace Vehicles best practices.

    Facebook catalog scheduled upload could be set in two modes: update and replace. The easiest way to configure a catalog is to select the replace mode. In this way, the catalog will be fully replaced at every upload (e.g. daily). If you want to remove a listing from Marketplace, simply remove it from your feed, and at the next upload it will be marked as removed. The listing may still be visible into Marketplace for the 24 hours that follow the upload.

    At the moment we share some basic daily metrics in CSV format, you can access them from your catalog's Settings page.

    No, you can also handle everything with a single catalog. In the feed upload section you can find two fields:

  • dealer_id: a unique identifier for the dealership. This value is a string, usually coming from your database.
  • fb_page_id: the Facebook professional page id of the dealers. Marketplace leads will be sent to this page. If you chose partner integration model (more info on integration models), put your Facebook page ID here. You'll receive all the leads, and based on the vehicle_id you will be able to understand its owner dealership. For dealer integration model, put the dealer's Facebook page ID, and the leads will be sent directly to their page. Please notice that you should have the right permissions to publish on behalf of this page to successfully ingest their listings.
  • If you prefer to keep things separated, you can also create a catalog for each dealership.


    We try to publish your listings or associated updates as soon as possible. Anyway, for optimization purposes, this process is asynchronous, which means that you won't be able to see the updates straight away after the feed upload. Changes to the catalog could take up to 24 hours to show up.

    There can be many reasons why this happens. The first thing to check is the health check status of the vehicle. In the catalog (Vehicles section) you should be able to check the status of every listing. If you see a red dot, with the label "Issues detected", you can move the cursor over the label, and get a more detailed description of the error. In many cases these issues will solve automatically in 24-48 hours, if this is not the case, please contact Facebook support.

    If the vehicle has been correctly ingested, you'll see a green dot, and by clicking on it you'll see the Marketplace listing.

    Common failure reasons include:

  • errors while fetching one or more image
  • invalid field value (price, coordinates)
  • mileage lower than 500
  • Leads API always check the partner's webhook response. If it's not successful, or if it's delayed (e.g. for network congestion, webhook down, etc.) we send the lead again after some time. This way we make sure that no leads are lost. Anyway, the side effect of this protection mechanism is that you may receive duplicates from time to time. The suggestion is to implement a filter on your webhook code, so you can check if a lead has been already received and discard possible copies of it.

    The top reasons why individual vehicles are rejected by Marketplace after being uploaded to the catalog are:

  • No permission to post on dealer’s Facebook page
  • Incorrect number of images (including no images, small images)
  • Incorrect mileage value
  • Incorrect or no description or VIN
  • Incorrect dealer Facebook page ID