API

Referencepas i jeres eget system

Inviter kandidater direkte fra jeres rekrutteringssystem, hent status, og få besked, når kandidaten sender sit pas. Virker med Zapier, Make og de fleste ATS'er, der kan kalde et API.

Opret API-nøgle Hjælp til integration

1. Log ind med en API-nøgle

Opret en nøgle under Integration på jeres virksomhedsside. Send den i hver forespørgsel:

Authorization: Bearer rp_live_…

Nøglen giver adgang til jeres virksomheds kandidater. Behandl den som en adgangskode, og slet den, hvis den slipper ud.

2. Inviter kandidater

Kandidaten får en mail fra Referencepas med en invitation fra jer. Op til 50 pr. forespørgsel og 30 pr. døgn.

curl -X POST https://referencepas.dk/api/v1/invites \
  -H "Authorization: Bearer rp_live_…" \
  -H "Content-Type: application/json" \
  -d '{"candidates":[{"name":"Sofie Kjær","email":"sofie@eksempel.dk"}]}'

201 Created
{ "sent": 1, "skipped": 0 }

3. Hent status

curl https://referencepas.dk/api/v1/candidates \
  -H "Authorization: Bearer rp_live_…"

{
  "candidates": [
    { "name": "Sofie Kjær", "email": "sofie@eksempel.dk", "status": "received",
      "since": "2026-10-27T09:12:00Z", "passport_url": "https://referencepas.dk/p/k7m2q9rx4d" }
  ]
}

status er invited (inviteret), started (pas oprettet) eller received (passet er sendt til jer). Referencerne selv ser I på passport_url, når kandidaten har sendt passet.

4. Webhook

Angiv en https-adresse under Integration. Vi sender en POST, når en kandidat sender sit pas til jer:

POST https://jeres-system.dk/referencepas
X-Referencepas-Event: candidate.passport_received
X-Referencepas-Signature: sha256=…

{ "event": "candidate.passport_received", "created_at": "2026-10-27T09:12:00Z",
  "data": { "name": "Sofie Kjær", "email": "sofie@eksempel.dk", "passport_url": "https://referencepas.dk/p/k7m2q9rx4d" } }

Tjek signaturen med jeres signeringsnøgle (HMAC-SHA256 af hele body):

const expected = "sha256=" + crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex");
if (expected !== req.headers["x-referencepas-signature"]) return res.status(401).end();

Teamtailor (via Zapier)

Sådan starter I Referencepas direkte fra Teamtailor – uden kode:

Trigger: Teamtailor → “Candidate moved to stage”, fx stadiet Referencer.
Handling: Webhooks by Zapier → POST til https://referencepas.dk/api/v1/invites med kandidatens navn og e-mail og jeres API-nøgle i headeren.
Retur: Opret et andet Zap med “Catch Hook” som webhook i Referencepas. Når passet kommer, tilføjer Zapier en note med linket på kandidaten i Teamtailor.

Samme opskrift virker med Emply, HR-Manager og de fleste andre systemer, der findes på Zapier.

Zapier og Make

Brug Webhooks by Zapier (eller Make's HTTP-modul): “Catch Hook” til at modtage pas, og “POST” til at invitere kandidater, fx når en kandidat flyttes til “Slutrunde” i jeres ATS.

Bruger I et system, vi ikke har en færdig opsætning til, så skriv til kontakt@referencepas.dk – så hjælper vi.