> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.vouch.careers/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.vouch.careers/_mcp/server.

# CANDIDATE_ADDED

POST 

Reference: https://docs.vouch.careers/api-reference/webhooks/candidate-added

## Request

### Headers

- `x-vouch-signature` (string, required) — HMAC-SHA256 signature: `t=<unix timestamp>,v1=<hex hmac of "{t}.{raw body}" keyed by your webhook secret>`. Reject requests older than 5 minutes.

### Payload

- `type` ("CANDIDATE_ADDED", required)
- `id` (string, required)
- `stage` (enum, required)
  - Allowed values: `PRESCREENING`, `REFERRAL_CREATED`, `READY_FOR_REVIEW`, `CONTACTED_BY_COMPANY`, `OFFER_MADE`, `HIRED`, `REJECTED`, `OUT_OF_PROCESS`
- `customStage` (string, required, nullable)
- `candidate` (CandidateAddedPayloadCandidate, required)
- `job` (CandidateAddedPayloadJob, required)

## Types

### CandidateAddedPayloadCandidate

- `id` (string, required, nullable)
- `firstName` (string, required, nullable)
- `lastName` (string, required, nullable)
- `email` (string, required, nullable)
- `phone` (string, required, nullable)
- `resumeUrl` (string, required, nullable)
- `linkedInUserName` (string, required, nullable)
- `portfolioUrl` (string, required, nullable)

### CandidateAddedPayloadJob

- `id` (string, required)
- `title` (string, required)