Recipes

Sync candidates into your system every 5 minutes (polling)

curl -s https://app.talvin.ai/api/v1/responses \
  -H "X-TALVIN-API-KEY: $TALVIN_API_KEY" \
  -H "X-TALVIN-ORGANIZATION-ID: $TALVIN_ORG_ID" \
| jq '.[] | {email, candidate_status, interview: .interview.name}'

React the moment a candidate is marked Selected (webhook)

1. Call POST /subscribe with eventType: "candidate_status_changed".
2. In your handler, check payload.candidate_status === "SELECTED".
3. Move the candidate forward in your ATS, or notify the hiring manager.

No-code option

If you’d rather not write any code, use the Zapier integration (Settings → Integrations → Platforms → Zapier). It uses this same API and connects Talvin to thousands of apps.