Generate a personal API token in Recruitee under Settings > Apps and Plugins > Personal API tokens; tokens do not expire unless manually revoked.
Authenticate all requests with the header Authorization: Bearer YOUR_TOKEN against the base URL https://api.recruitee.com/c/{company_id}/.
POST to /candidates with a JSON body containing at minimum the candidate's name and at least one email address; the rate limit is 1,000 requests per minute per API token.
To assign the candidate to a specific job, include the offer_id in the POST body or make a follow-up request to link the candidate to the offer via the candidate-offers endpoint.
Confirm creation by checking the 201 response for the candidate ID and verify the assignment appears in the Recruitee UI or via a GET on the candidate record.
Known gotchas
Company ID (the subdomain identifier used in the API base URL) is distinct from the Recruitee account subdomain shown in the UI; confirm the correct numeric company_id from Settings before making API calls.
The API token's permissions are inherited from the hiring role of the user who created it; a token from a user without access to a specific job will not be able to assign candidates to that job.
Candidate deduplication is not automatic; posting the same email address twice creates separate records — check for duplicates before creating.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp