How it works
- When a connection is created, Nango automatically fetches the connected Jobber account’s ID and stores it for webhook routing — no setup needed on your end.
- Jobber sends a signed POST request to your Nango webhook URL when a subscribed event occurs.
- Nango verifies the signature, matches the payload’s
accountIdto the correct connection, and forwards the event to your app.
Setup
1. Get your Nango webhook URL
In the Nango dashboard, open your Jobber integration and copy the Webhook URL.2. Register the webhook in Jobber
- Go to Manage Apps and open your app.
- Add a webhook pointing to your Nango webhook URL, and select the topics you want to subscribe to.
3. Handle forwarded webhooks
Every request from Jobber includes anX-Jobber-Hmac-SHA256 header — a Base64-encoded HMAC-SHA256 of the raw request body, signed with your app’s OAuth client secret. Nango verifies this automatically before forwarding the event. Example payload:
Jobber provides at-least-once delivery. Your webhook handler should be idempotent and respond within 1 second — process payloads asynchronously to stay within this limit.
Handle the webhook
Once routed to a connection, you have two options:- Forward it to your app — Nango verifies the signature and forwards the event to your webhook URL with connection attribution. See External webhook forwarding.
- Process it in a sync — run a sync when the webhook arrives using
webhookSubscriptionsandonWebhookin a sync script. See Real-time syncs.
Supported topics
Webhooks fire for any topic configured in your Jobber app. Examples:
For the full list, see
WebHookTopicEnum in the Jobber GraphQL schema.