Connect to the API

Authentication

All requests that reach SmartRecruiters Marketplace API will require a Token. The API Token is a 64-characters string that is auto-generated during the signup process.

Obtain the token

You can obtain the API Token by signing up in the SmartRecruiters marketplace. After successful registration, the API token will be presented on the API page in the partner account.

Pass the token

Please pass the API Token for authentication as a HTTP request header.

Pass Token as an URL parameter

Authentication mechanism will always start with checking the apiKey parameter. If present, it will be used to authenticate incoming request:

Example:

http://api.smartrecruiters.com/v1/offers/511a3942300469a9c33819d8?apiKey=b880fg361c851c0773b422eb3b96cc947934e44303b6fe12e44ac736a9dedb0z

Pass Token as an http request header

If the apiKey URL parameter is not present, the authentication mechanism will check request headers. The API Token can be passed using X-SmartToken header.

Example:

curl -i -H "X-SmartToken:b880fg361c851c0773b422eb3b96cc947934e44303b6fe12e44ac736a9dedb0z" -X GET https://api.smartrecruiters.com/v1/offers/511a3942300469a9c33819d8