Skip to main content

Personal Access Tokens

Personal Access Tokens (PAT) are personal authentication tokens that let you access Recrut'Auto from your external tools: MCP server, REST API, scripts, in-house integrations. They are scoped to your subscription and respect your permissions.

Generate a token

  1. Log in to console.recrutauto.fr.
  2. Open your user menu (top right) then click My account.
  3. Scroll down to the Access tokens section.
  4. Enter a descriptive name (e.g. "Claude Desktop — my Mac", "ATS sync script", "Cursor desktop").
  5. Click Create token.

The token then appears in clear text, prefixed with ra_:

ra_a1b2c3d4e5f6...
Shown only once

The full token is displayed only once, at creation time. Copy it immediately and store it in a secrets manager (1Password, Bitwarden, a .env.local environment variable, etc.). If you lose it, revoke it and generate a new one.

Token list

For each token, the section shows:

FieldDescription
NameThe name you chose
PrefixThe first 8 characters (e.g. ra_a1b2c3...), for identification only
Created onCreation date
Last usedTimestamp of the last authenticated call with this token
Expires onExpiration date if configured (optional)
StatusActive / Inactive

Revoke a token

  1. In the list, click the trash icon to the right of the token.
  2. Confirm the revocation.

The token is invalidated immediately: any request using it will receive a 401 Unauthorized error. This action is irreversible.

Best practices
  • One token per integration — easier to revoke individually if compromised.
  • Explicit naming — include the machine or tool (e.g. "Work laptop — Cursor").
  • Watch "Last used" — revoke dormant tokens.
  • Never commit a token to Git — always use an environment variable.

Personal tokens vs organization keys

Recrut'Auto distinguishes two kinds of tokens:

Personal Access TokenOrganization API key
Where to createMy account › Access tokensOrganization › Developers
Prefixra_…ra_live_… / ra_test_…
ScopeYou (your campaigns, candidates, permissions)The organization (CI/CD, server integrations)
MCP server (Claude)✅ Yes❌ No
REST API✅ Yes✅ Yes

To use Claude (MCP server), create a personal token: the MCP server always acts as an identified member and does not accept organization keys. Organization keys are for server-to-server integrations (CI/CD, ATS sync, SCIM) on the REST API, and are managed under Organization › Developers.

Usage

Once your token is generated, see:

  • MCP documentation — to configure Claude Desktop, Cursor, or Claude Code.
  • REST API — to call the HTTP endpoints directly.