App Logo
welcomekit.co

Move ATS candidate stage

Move an ATS candidate to another pipeline stage by stage id or label (built-in ref, UI alias, or custom column name). Returns from/to stages, and verifies the move actually applied since the underlying API silently no-ops on a wrong payload.

Input

org required

Organization reference as it appears in your dashboard URL https://www.welcomekit.co/dashboard/o/<org>/ (6-char code).

candidateReference required

Candidate reference from list_candidates, format: <orgprefix>-<24 hex chars>

stage optional

Target stage as label: built-in reference (initial, to_refuse, refused, to_meet, interviewed, made_offer, hired), UI alias (New, Rejected, Awaiting Rejection, Offer) or custom column name (e.g. Test sent). Case-insensitive.

stageId optional

Target stage id (from list_jobs/list_candidates stages). Wins over stage when both given.

Output

toStageId required
candidateReference required
toStage optional
fromStage optional
updatedAt optional
fromStageId optional
jobReference optional

Start building not clicking