Manatal API

13 endpoints for Manatal, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/manatal
Connects with: Your own Manatal login (you enter the 2FA code yourself if your account uses it). Admins see every match; Manager, Consultant and Recruiter see public organizations and the jobs of their teams.
Integration page: Manatal

Read (8)

Return data and change nothing in the account.

Manatal Endpoints: Read
Endpoint	Description
GET /candidates/search	Candidates matching a name, email, position, company or tag.
GET /candidates/{candidate_id}	One candidate profile with contact details, education and work history.
GET /candidate-notes	Notes on a candidate profile, with author and date.
GET /jobs/search	Jobs by title, organization or location.
GET /jobs/{job_id}	One job with description, organization and its pipeline stages.
GET /job-pipelines	Candidates on a job, by pipeline stage, with their match IDs.
GET /drop-reasons	The drop reasons your Manatal account offers.
GET /organizations/search	Client companies or departments by name or location.

Change the account. Calls marked Confirm wait for the user to approve them.

Manatal Endpoints: Write
Endpoint	Description
POST /candidates Confirm	A new candidate profile with name, contact details and current position.
POST /candidates/{candidate_id}/note Confirm	A note on a candidate profile, optionally tagging team members.
POST /jobs/{job_id}/candidates/{candidate_id}/to-job Confirm	Links a candidate to a job so they show in its pipeline.
POST /match/{match_id}/candidate-stage/move Confirm	Moves a candidate on a job to another pipeline stage.
POST /match/{match_id}/candidate/drop Confirm	Drops a candidate from a job with one of the account's drop reasons.