---
updatedAt: 2026-08-12T15:21:03.000Z
---

Fetch the complete documentation index at: https://docs.recruitee.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Authentication

Careers Site API access to your Tellent Recruitee data.

<Callout icon="⚠️" theme="error">
  ### Important

  Deadline for introducing the token to calls is **10 February 2027**

  Calls without the authorization header will return the `401 Unauthorized` error
</Callout>

In order to use the Careers Site API, a client (any application that would like to use the API) needs to authenticate first with a header:&#x20;

```curl
curl -X GET \
  https://recruiteedemo.recruitee.com/api/offers \
  -H 'X-Careers-Sites-Token: <token>'
```

<Callout icon="📌" theme="info">
  ### Token scope

  The token only covers the endpoints mentioned in the documentation:

  **/offers**

  **/offers/:id&#x20;**

  **/offers/:offer_slug/candidates&#x20;**

  The XML offer feed and jobs widget are not covered by the Careers API token

  Each user can generate an API Token that will have the exact same scope of permissions as the user - it will allow to perform the same actions as in the web or mobile application **in the name of that user.**

  Currently it's not possible to set the access level of the API Token (e.g. with lower or higher access level) or turn off API Token generation for some roles.

  Be careful when sharing your API Tokens with other people.
</Callout>

## Generate API Token

To start, go to [token settings](https://app.tellent.com/ats/settings/api_tokens). You can find them in Settings > Apps and plugins

<Image src="https://files.readme.io/1428bf943bb94cc8d2eb1ca5b0ca10f2b8f3e43b4198c04065db3c88277a2b93-CleanShot_2026-08-12_at_17.04.21.png" align="center" />

You should now see an overview of your API Tokens.

![](https://files.readme.io/adf2bfd7082807dff666ddb68fcff06961026e062e062c1e27238b4a0dbb19de-CleanShot_2026-08-12_at_17.05.15.png)

Navigate to **Careers API tokens**

![](https://files.readme.io/c3190c89de81e7657c76b1f0700d806761423d3bc9408873cade65fbf140fab1-image.png)

Click on **+Add token > Careers API token&#x20;**&#x61;nd provide the API Token label. Click **Save**.

You can now use the token for your integrations.&#x20;

<Callout icon="📘" theme="info">
  ### Users in multiple companies

  Careers API token only covers single account's Careers Site API. If you are a user in multiple companies, you need to generate the token for every company account to retrieve access to the API.
</Callout>

<br />

<Callout icon="❗️" theme="error">
  ### Revoking your API Tokens

  You can revoke your API Tokens anytime, but any integrations using it will stop working - each request that needs authentication will then return `401 Unauthorized` status.<br />Since it's not possible to regenerate existing API Tokens, you will have to create a new API Token and update it in your integration.
</Callout>

<br />

<br />