Generate a Public Read API key in Teamtailor Settings > Integrations > API keys; this key only has access to publicly visible data
Call GET https://api.teamtailor.com/v1/jobs with header Authorization: Token token=<API_KEY> and X-Api-Version: 20240404 (or the current supported version) to retrieve published jobs
The response follows JSON:API format; each job object is in the data array with attributes including title, body (description), and relationships to department and location
Fetch related resources (departments, locations) from the included array in the same response or via their individual endpoints to build filter UI
Render the job list on your careers embed, linking each job to its Teamtailor-hosted or custom application URL from the links.careersite-job-url attribute
Known gotchas
Teamtailor enforces a rate limit of 50 requests per 10 seconds; fetching all jobs plus all related resources in separate requests can exhaust this quickly — use the ?include=department,locations query parameter to fetch related data in one request
The X-Api-Version header is required; omitting it may return data in a deprecated format or cause unexpected behavior
Teamtailor operates separate regional API endpoints (api.teamtailor.com for EU, api.na.teamtailor.com for North America, api.au.teamtailor.com for APAC); using the wrong regional endpoint returns a 401 even with a valid key
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