API: Webhook-events

Outbound webhooks sender JSON til jeres URL når noget sker i Salesbase (ny lead, deal vundet, tilbud sendt osv.). Abonnementer oprettes via API med webhooks-scope.

Artiklen er til udviklere der bygger event-drevne integrationer mod Salesbase.

Forudsætninger

• API-nøgle med webhooks-scope
• HTTPS-endpoint der kan modtage POST og svare med HTTP 2xx

Sådan gør du

1. Opret abonnement: POST /api/v1/webhooks/subscriptions med ønskede event-typer og callback-URL
2. Gem signing secret fra response til verificering
3. Modtag payloads og verificér header X-Webhook-Signature (HMAC-SHA256)
4. Svar hurtigt med 2xx. Behandl data asynkront i jeres system

Vigtige events (2026)

• deal.updated og deal.stage_changed når du gemmer en deal eller flytter den i Pipeline (ikke kun via API)
• deal.won / deal.lost når dealen markeres vundet eller tabt
• custom_object.* for brugerdefinerede objekter
• offer.* for tilbud (sendt, accepteret osv.)
• booking.* for bookinger
• support_ticket.* for support

Fuld event-katalog: GET /api/v1/docs?section=webhooks eller Indstillinger → API → Dokumentation.

Resultat

Jeres system reagerer automatisk på CRM-hændelser uden polling, og I kan bygge synkronisering, logging eller workflow i eget miljø.

Fejlsøgning

Symptom	Løsning
Webhook leveres ikke	Tjek at URL er HTTPS og returnerer 2xx inden timeout
Signatur fejler	Brug rå body og samme secret som ved oprettelse
Event mangler	Bekræft event-navn mod dokumentationen
Make får intet når du flytter en deal i Pipeline	Abonnér på deal.stage_changed og deal.updated. Gem eller flyt dealen i Salesbase, og tjek at scenariet er slået til

Relateret

• API og webhooks overblik
• API: Inbound webhooks
• API: Brugerdefinerede objekter