Authenticate all requests with your SmartRecruiters API key by including the X-SmartToken header on every request
To create a new job posting, send POST https://api.smartrecruiters.com/jobs with a JSON body containing at minimum title, department, location, and jobAd (containing the job description sections)
To publish the job so it appears externally, send POST https://api.smartrecruiters.com/jobs/{jobId}/publication after creation; unpublished jobs are drafts only
To retrieve existing postings, send GET https://api.smartrecruiters.com/v1/companies/{companyIdentifier}/postings/{postingId} for a specific posting or GET https://api.smartrecruiters.com/jobs with query parameters to list jobs
To update job content, make the edits in the SmartRecruiters UI or via the job PATCH endpoint and then re-publish; the Posting API reflects the published state and cannot be updated independently of the underlying job record
Check the SmartRecruiters developer portal at developers.smartrecruiters.com for the OpenAPI specification and Swagger UI to explore all available endpoints and their required fields
Known gotchas
Updating the content of a job posting via the API requires re-publishing the job; editing the Posting API response fields directly is not supported
The API key authentication (X-SmartToken) is for customer-built private integrations; productized partner apps must use OAuth 2.0 — confirm the correct auth method for your use case
Job IDs and company identifiers differ between sandbox and production environments; test in the SmartRecruiters sandbox before connecting to production
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