Comeet API

12 endpoints for Comeet, 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/comeet
Connects with: Your own Comeet (Spark Hire Recruit) account; changing status needs a position role of recruiter, recruiting coordinator, hiring manager, manager or recruiting assistant
Integration page: Comeet

Read (6)

Return data and change nothing in the account.

Comeet Endpoints: Read
Endpoint	Description
GET /positions	Positions you can see, with department, location, status and hiring team.
GET /positions/{position_id}	One position with its workflow steps, hiring team and openings.
GET /positions/{position_id}/candidates	Candidates of a position with status, current step, assignee and source.
GET /candidates/{candidate_id}	One candidate with profile details, status, workflow steps and tags.
GET /my-tasks	Candidates with a task assigned to the signed-in account, as in My tasks.
GET /candidate-activities	Comments, emails, meetings and status changes from a candidate's activity log.

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

Comeet Endpoints: Write
Endpoint	Description
POST /candidates/{candidate_id}/tag	Add a tag to a candidate, or remove one.
POST /positions/{position_id}/candidates Confirm	Create a candidate on a position.
POST /candidates/{candidate_id}/comments Confirm	Post a comment on a candidate profile and tag teammates with @.
PUT /candidates/{candidate_id}/status Confirm	Change a candidate to in progress, on hold, rejected, withdrawn or hired.
POST /candidates/{candidate_id}/go-no-go/decide Confirm	Click Go or No-go on a candidate's Go/No-go step.
POST /candidates/{candidate_id}/self-schedule/invite Confirm	Email a candidate a link to pick their interview time.