addCandidates
Add people to the workspace's candidates, 200 at most a call. Someone already among the workspace's candidates (the same LinkedIn profile, whatever the address's scheme, www., query or trailing slash; else the same email address in any case) is not added again: their record is returned unchanged, with wasCreated false. A person still in Kith ATS's own sourcing review is not a candidate of the workspace yet, so they are never matched, and a new record is added. Two entries of one call that name the same person are one record. Sending the same people again returns the same records. Each new candidate starts the workspace's agents for new candidates, once the request is saved.
addCandidates(
input: AddCandidatesInput!
): AddCandidatesPayload!Arguments
addCandidates.input · AddCandidatesInput! non-null input
Who to add.
Type
AddCandidatesPayload object
What was added.
addCandidateNote
Leave a note on a candidate, about a job or in general. The signed-in member is recorded as its author. Without a reference every call leaves another note. With `requestId`, a retry returns the note the first request wrote, with `wasCreated` false, and changes nothing; that id on another candidate's note is `REQUEST_ID_IN_USE`. With `externalSource` and `externalId`, a note is stored once in the same way; the pair on another candidate's note is `EXTERNAL_ID_IN_USE`. A note about a job needs the candidate on that job: `CANDIDATE_NOT_ON_JOB` otherwise. A note about a job, with words in it, on a candidate Kith delivered for that job is sent to Kith once the request is saved; a general note (no job) never goes to Kith, nor does a note brought in from Kith.
addCandidatesToJob
Put candidates on a job, 200 at most. A new place is graded for the job straight away, and once the request has been saved the job's graded candidates are re-ranked against the caller's recruiter framework, when they have one. A candidate already on the job is not added again: their place is returned unchanged with `wasAdded` false, so repeating this adds nothing. A candidate given twice is added once.