Webhooks
Hvad er webhooks?
Webhooks sender automatisk en HTTP POST til din server når specifikke begivenheder sker. Det lader dig synkronisere ændringer i realtid med fx dit CRM, Slack eller en database.
Opret en webhook
- 1
Gå til Virksomhed → API.
- 2
Scroll ned til "Webhooks" og klik "Opret webhook".
- 3
Indtast din endpoint-URL. Den skal være HTTPS.
Vi blokerer private IP-adresser for at forhindre SSRF-angreb.
- 4
Vælg hvilke begivenheder der skal udløse webhook'en.
- 5
Klik "Gem". Vi sender straks en test-payload som du kan tjekke i din log.
Tilgængelige begivenheder
- onboarding.created: ny onboarding oprettet.
- onboarding.completed: alle påkrævede trin udfyldt.
- onboarding.updated: felter på onboardingen er ændret.
- onboarding.archived: onboarding arkiveret.
- step.completed: et trin er markeret som færdigt.
- step.rejected: du har afvist et trin med begrundelse.
- comment.created: ny kommentar på et trin.
- deadline.approaching: 24 timer før deadline.
- file.uploaded: klienten har uploadet en fil.
Signering og retry
Hver webhook signeres med HMAC ud fra din endpoint-hemmelighed. Verificér headeren `X-OnboardSync-Signature` for at sikre at request kommer fra os.
Fejlede leveringer (5xx, 408, 429, netværksfejl) genprøves automatisk med eksponentiel backoff: 1 min → 5 min → 30 min → 2 t → 6 t → 24 t. Efter 6 forsøg markeres leveringen som mislykket.
Tip: Brug "Send test-event" knappen for at validere din endpoint inden du tager den i produktion. Den fulde payload-struktur er dokumenteret på Virksomhed → API-siden.