Getting Started

This page quickly outlines the key steps to get your jobs live on Facebook. Check out the How-To page to go deeper on these concepts, or the FAQ page for common questions.

Quick Intro: Creating a Facebook Jobs XML Feed in 15 Minutes

Check out the below video for a full guide, end-to-end, on how to build out your XML feed. Note that the video assumes you already have Jobs API permissions.

Something Went Wrong
We're having trouble playing this video.

1. Generate your XML Feed

You will need to publish an XML file at a URL where Facebook's crawler can read it. This is known as your XML Feed. The full format specification, along with sample XML files, is located on the Jobs XML Feed Specification page.

Receiving Applications

We will notify you when you receive an application at the application-callback-url endpoint you provide. See full details on this callback, and how to retrieve the applications, in the How-To section.

Example Job Posting

The following is a sample of how the job will appear on Facebook.

2. Receive Jobs API Permissions

In order for Facebook to start ingesting your jobs, we must grant you the necessary permissions in order to continue work on the integration. Speak with your Facebook contact to understand your permissioning status. Note that these APIs have a 30-day usage policy - if the permission is not used 30 days after granting, it will be revoked. Note that you will receive errors indicating you do not have the correct permissions when attempting all further API calls if you don't have permission. See details here for how to receive for access (note we do not grant access to all applicants).

You cannot proceed further in this guide until you are approved—the bulk of the work exists in step 1, however, so if you build out a full XML feed you can be ready to quickly complete registration once permissions are granted.

3. Set Your App to Live

Your app needs to be set to "Live Mode" to import jobs. Go to your App Dashboard and find the toggle at the top of the screen for your App. Switch it to "Live".

4. Create Your Recruiting Manager and Job Feeds

To manage jobs on Facebook all developers must set up a Recruiting Manager object. A Recruiting Manager allows you to configure your company properties such as your ATS name, website URL and data policy URL.

Sample Request

HttpRequest: POST
URL: https://graph.facebook.com/vX.X/${user_id}/recruiting_managers?access_token=${user_access_token}

Sample Body

{
  "name": "YourCompanyName",
  "website_url": "https://www.yourcompanywebsite.com/",
  "data_policy_url": "https://www.yourcompanywebsite.com/datapolicy.html"
}

Note: The page located at data_policy_url should be mobile friendly

Sample Response

{ 
  "id": recruiting_manager_id
}

Learn how to generate a user access token.

Register Your Recruiting Manager

Once you have created a recruiting manager, you must notify Facebook by submitting a "Register Recruiting Manager" question in the Direct Support Tool, otherwise your feed will not be read, and jobs will not be posted.

Documentation for Direct Support Tool is here. If you do not have access to the Direct Support Tool, please reach out to your contact at Facebook. Note that you can only register one recruiting manager.

Create Your Jobs Feed

Creating a feed object allows Facebook to crawl the XML file you created in step 1 and post the jobs on the jobs browser.

  • We recommend having only one job feed containing the jobs for all your companies.
  • There is a limit of 100 total job feeds. If you create more than 100 job feeds, your integration will be shut off.
  • The crawler has a 60 second timeout in loading a job feed.

Note: Feed creation uses app access tokens.

HttpRequest: POST
URL: https://graph.facebook.com/vX.X/${recruiting_manager_id}/job_feeds?access_token=${app_id|app_secret}

Sample Body

{
"feed_url": "https://yourcompany.com/link-to-jobs-xml-feed.xml",
"syncing_frequency": "NONE"||"HOURLY"||"SIX_HOURS"||"TWELVE_HOURS"||"DAILY"
}

Sample cURL

curl --request POST --header 'Content-Type: application/json' --data \
    '{ 
        "feed_url": "https://yourcompany.com/link-to-jobs-xml-feed.xml",
        "syncing_frequency": "DAILY"
    }' \
    "https://graph.facebook.com/v7.0/${recruiting_manager_id}/job_feeds?access_token=${app_id|app_secret}"    

Sample Response

{
  "id": jobs_feed_id
}

Jobs API Reference

Note: These API reference pages are only visible once you have been granted Jobs API permissions; see step #2 above.

Learn More