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

The following section describes the fields needed in your XML feed to properly ingest jobs, including a sample feed.

Required Fields

  • publisher-name : The name of your organization
  • publisher-url : The URL of your organizations's website
  • title : The job title
  • date : The date the job was posted
  • id : A unique ID of your choosing that distinguishes this job from all other jobs you provide Facebook
  • description : The job description
  • company-name : The name of the hiring company
  • company-id: A unique ID of your choosing that distinguishes this hiring company from all other hiring companies you provide in your XML feeds
  • company-full-address : The full address of the hiring company
  • company-url : The URL of the hiring company (URL format:
  • facebook-apply-data : A wrapper tag that contains tags for your callback URL (see below) or any other custom application requirements (see How-To section)
  • application-callback-url : A URL you provide us that we will notify whenever your job receives an application (see How-To section for more details)

Note: All fields are plain text. HTML tags are not supported.

Default Fields

Default fields are not required, but will default to a particular value if the xml tag is not present.

  • job-type (defaults to: full_time)
  • company-page-matching-approach : Determines whether or not you want your job to be matched to a Facebook page. Set to "none" to prevent the job from being matched to a page, otherwise put "standard". (defaults to: standard)

Full Feed Specification

All required, default, and other possible fields are listed in this sample XML document below.

<?xml version="1.0" encoding="utf-8"?>

<publisher-name>Your ATS</publisher-name>
<last-build-date>2017-11-06 18:47:08 +0000</last-build-date>


<!-- basic info -->
<title><![CDATA[Example Engineer]]></title>
<date><![CDATA[2017-11-06 18:47:08 +0000]]></date>
<description><![CDATA[Example job description]]></description>
<job-type><![CDATA[full_time, part_time, contract, internship, volunteer]]></job-type>

<!-- company info -->
<company-full-address><![CDATA[1 Hacker Way, Menlo Park, CA, 94025]]></company-full-address>
<company-page-matching-approach><![CDATA[standard, none]]></company-page-matching-approach>

<!-- location -->
<full-address><![CDATA[1 Hacker Way, Menlo Park, CA, 94025]]></full-address>
<street-name><![CDATA[Hacker Way]]></street-name>
<city><![CDATA[Menlo Park]]></city>

<!-- salary -->

<salary-type><![CDATA[hourly, daily, weekly, biweekly, monthly, annually, one-time]]></salary-type>

<!-- integration configuration -->





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. Register Your Recruiting Manager and Job Feeds

To manage jobs on Facebook all developers must set up a Recruiting Manager. A Recruiting Manager allows you to configure your company properties such as your ATS name, website URL and data policy URL. Once you have created a recruiting manager, you must notify Facebook by submitting an answer to the "Register Recruiting Manager" question in the Direct Support Tool, otherwise your jobs will not be posted. 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 with Facebook, although you can have an indefinite number of jobs or feeds associated with that recruiting manager.

Sample Request

HttpRequest: POST

Sample Body

  "name": "YourCompanyName",
  "website_url": "",
  "data_policy_url": ""

Note: The data_policy_url should be mobile friendly

Sample Response

  "id": recruiting_manager_id

Learn how to generate a user access token.

Register Your Jobs Feed

Registering the XML Feed allows Facebook to crawl the feed and post jobs on the jobs browser. Each feed cannot have more than 30,000 jobs. To publish more than 30,000 jobs, the recommendation is to split them into multiple feeds and maintain 1:1 mapping between the jobs and job_feed_id. Note there is a limit of 100 total Job Feeds . If you provide more than 100 job feeds, your integration will be shut off.

Note: XML Feed registration uses app access tokens.

HttpRequest: POST

Sample Body

"feed_url": "",
"syncing_frequency": "NONE"||"HOURLY"||"SIX_HOURS"||"TWELVE_HOURS"||"DAILY"

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