Resources
API documentation
Automate your hiring workflow with outbound webhooks on every plan, or the full REST API on Enterprise.
Available now: webhooks
Every plan can connect a Zapier webhook from Settings. FocalVAHire sends a POST request with the full candidate payload whenever a tracked event happens — no polling required.
| Event | Description |
|---|---|
| candidate.status_changed | Fires every time a candidate moves to a new pipeline status (Shortlisted, Approved, Rejected, Advanced). |
Enterprise: the REST API
Enterprise plans get a full read/write REST API to pull and push jobs and candidates from your own systems. Generate a key from Settings → Developer, then send it as a bearer token on every request:
curl https://focalvahire.com/api/v1/jobs \ -H "Authorization: Bearer fvh_live_..."
| Endpoint | Description |
|---|---|
| GET /api/v1/jobs | List all your jobs. |
| POST /api/v1/jobs | Create a job. |
| GET /api/v1/jobs/:id | Get a single job. |
| PATCH /api/v1/jobs/:id | Update a job. |
| GET /api/v1/candidates | List candidates. Filter with ?jobId= or ?status=. |
| GET /api/v1/candidates/:id | Get a single candidate, including review scores. |
| PATCH /api/v1/candidates/:id/status | Update a candidate's pipeline status. |
Rate limit: 300 requests per 5 minutes per key. Every response is JSON; errors return { "error": "..." } with a matching HTTP status code.
Not on Enterprise yet?
Talk to us about upgrading to unlock API access, white-glove onboarding, and volume pricing.
Contact sales