API - Posting via ATS multi-posting systems

API User Setup

First contact sales support on 0141 302 7134 to set up a new API user for posting to s1jobs or x1jobs

You can also request by emailing customerservice@s1jobs.com

ATS Setup

1. You will need to check if your ATS provider is already integrated to our website. You can check with your account manager or customer service when you request an API user if your ATS is already integrated. Existing provider examples are Broadbean, Idibu, Firefish and Logicmelon. There are many more providers who have the API integrated.
2. If you're setting up a new ATS provider or a custom API directly from your business the API documentation on this page will need to be used by your developers or the ATS provider you're using.
3. Please can you provide the link
4. The set-up time for connecting a new jobs feed to our API is normally 4-8 weeks to allow time for your developers (or ATS provider) to build and test the jobs feed.

New API Provider - Developer Documentation

For any new setup or to check any errors on the API please use the Documentation below. We recommend you always access this link when carrying out work to ensure the most recent version is used.

API Specification v 08-2022

How to get access

To POST jobs onto one of our job boards, you will need to contact Sales Support and setup a “Company Admin” user and to setup an API user. This user will be attached to a company that you must also provide.

Authentication

Sales support will provide you with a API username (key) and password (value) that you must send in your POST request. The keys are “username” and “password”.

URL

The request must be a POST request with the URL:

recruiter.x1jobs.com/api/job

In the Headers, you must send Content-Type of application/json and the Body should be JSON. The key/values for the Body will be provided later on in this document.

Error Handling

Our system will return standard error messages. A standard error message to be returned is:

{

"_status": "ERR",

"_error": {

"message": "username and/or password incorrect or not provided2",

"code": 403

}

}

As you can see, the code is provided along with the message of what has went wrong.

Posting Data

Required

One of the following is also required

Optional

If the following are not sent, no default will be used.

Data Types

Coreskill/Specialism data

Specialisms have a relationship with a coreskill. 1 coreskill can have many specialisms but 1 specialism can only have 1 coreskill. When sending the data, you must ensure that the specialism sent has a relationship with the coreskill also being sent otherwise it will fail.

Document Version: 01-2022