Developers / Hosted Onboarding API

Onboarding in je eigen software, zonder het zelf te bouwen.

Formulieren, identiteitscontrole, vierogen, contracten en de koppeling met de salarisadministratie: wij regelen het. Jij stuurt je gebruiker naar onze pagina en volgt de voortgang via webhooks.

POST /api/public/v1/onboardings

curl https://app.agreli.nl/api/public/v1/onboardings \
  -H "Authorization: Bearer hrs_test_…" \
  -H "Idempotency-Key: 7c4b…" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "sollicitant-4711",
    "employee": { "first_name": "Sam", "last_name": "Jansen",
                  "email": "sam@example.com" },
    "employment": { "position": "Bediening",
      "start_date": "2026-12-01", "location_id": "loc_…",
      "template_id": "t1", "hours_per_week": 16,
      "hourly_wage_cents": 1450 },
    "options": { "return_url": "https://jouwapp.nl/klaar" }
  }'

Antwoord

HTTP/1.1 201 Created

{
  "id": "onb_8f2c…",
  "object": "onboarding",
  "status": "pending_employee",
  "hosted_url": "https://app.agreli.nl/m/…",
  "expires_at": "2026-10-26T12:00:00Z",
  "invitation_sent": false,
  "reference": "sollicitant-4711"
}

Zo werkt het

Create → Redirect → Verify → Webhook.

Stap 1
Create
Maak een onboarding aan met één API-call. Je krijgt een id, een hosted_url en een vervaldatum terug.
Stap 2
Redirect
Stuur de medewerker naar de hosted_url. Die pagina is in de huisstijl van de werkgever.
Stap 3
Verify
De medewerker bevestigt met een eenmalige code. De link alleen geeft nooit toegang tot een dossier.
Stap 4
Webhook
Je ontvangt ondertekende webhooks: ingevuld, goedgekeurd, contract getekend, verwerkt in de salarisadministratie.

Gebouwd voor productie

Veilig standaard, niet als optie.

Sandbox en productie gescheiden

Testsleutels werken in een aparte sandbox met fictieve medewerkers, opgevangen mails en een gesimuleerde salarisverwerking.

Idempotency-Key

Hetzelfde verzoek nog eens geeft hetzelfde antwoord. Opnieuw proberen na een time-out is veilig.

Ondertekende webhooks

HMAC-SHA256 met tijdstempel, een event-id om te ontdubbelen en herhaalpogingen tot een dag later.

Geen persoonsgegevens in events

Webhooks bevatten alleen id's, je eigen referentie en de versie. Details haal je op met je sleutel.

Toegang per werkgever

Een partner werkt alleen voor werkgevers die dat uitdrukkelijk hebben toegestaan, met de rechten die zij kiezen.

Developer dashboard

Sleutels, webhooks met afleveringen, een logboek van verzoeken en je verbruik, live en sandbox apart.

Webhooks controleren

Twee regels code.

Elke webhook heeft een Agreli-Signature-header met een tijdstempel en een HMAC-SHA256-handtekening. Controleer beide voordat je een event verwerkt.

webhook.js

// Node.js: Agreli-Signature: t=<unix>,v1=<hex>
const [, t, v1] = header.match(/^t=(\d+),v1=([0-9a-f]+)$/);
const geldig = crypto.timingSafeEqual(
  Buffer.from(v1, "hex"),
  crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest()
) && Date.now() / 1000 - Number(t) < 300;

Docs voor mensen en agents

Bouw het met je AI-assistent.

Bijna niemand schrijft een koppeling nog helemaal met de hand. Daarom staat de documentatie er ook als Markdown, in één bestand en als OpenAPI-specificatie. Geef de link aan Cursor, Claude Code of ChatGPT en begin.

Opdracht voor je assistent

Bouw een koppeling met de Agreli Hosted Onboarding API.
Lees eerst https://agreli.nl/llms-full.txt en gebruik https://app.agreli.nl/api/public/v1/openapi.json als bron voor endpoints en velden.
Gebruik een testsleutel (hrs_test_…) uit de omgevingsvariabele AGRELI_API_KEY.
Stuur bij elke POST een Idempotency-Key mee en controleer de Agreli-Signature van elke webhook.

Prijs en toegang

Gratis testen, betalen per afgeronde onboarding.

De sandbox is direct en gratis beschikbaar. Productietoegang vraag je aan in het developer dashboard; we kijken mee voordat je met echte gegevens werkt. Daarna betaal je €7 per volledig afgeronde onboarding.

Begin in de sandbox API-docs

€7

per afgeronde onboarding

Sandbox gratis
Volumetarieven volgen
Je betaalt alleen voor helemaal afgeronde onboardings