For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

API
- Getting Started
Webhooks
- Getting Started
API Reference

Getting Started
Getting Started
Webhooks
LISTING_CREATED
LISTING_UPDATED
CANDIDATE_ADDED
CANDIDATE_STAGE_UPDATED
CANDIDATE_HIRED
Listings
List listings
Get a listing
Candidates
List candidates for a listing
Get performance metrics for a listing

API Reference Webhooks

CANDIDATE_HIRED

Payload

1 {
2   "type": "string",
3   "id": "string",
4   "startDate": "2024-01-15T09:30:00Z",
5   "candidate": {
6     "id": "string",
7     "firstName": "string",
8     "lastName": "string",
9     "email": "string",
10     "phone": "string",
11     "resumeUrl": "string",
12     "linkedInUserName": "string",
13     "portfolioUrl": "string"
14   },
15   "job": {
16     "id": "string",
17     "title": "string",
18     "salary": {
19       "type": "string",
20       "currency": "NOK",
21       "minSalary": 1.1,
22       "maxSalary": 1.1,
23       "extra": "string"
24     },
25     "employmentType": [
26       "Full-time"
27     ]
28   }
29 }

Was this page helpful?

Listings

Headers

x-vouch-signaturestringRequired

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

The payload of this webhook request is an object.

type"CANDIDATE_HIRED"Required

idstringRequired

startDatedatetime or nullRequired

candidateobjectRequired

jobobjectRequired

Response

200

Acknowledge receipt. Any non-2xx response is retried.