Overview
Webhooks allow your application to receive real-time HTTP notifications when events occur in FieldWise. Instead of polling the API, webhooks push data to your endpoint instantly.Supported Events
Webhook Payload
Payload Fields
Security Headers
Every webhook includes these headers:Signature Verification
Always verify webhook signatures to ensure requests come from FieldWise.Retry Policy
Failed deliveries are automatically retried:
After 3 failed attempts, the webhook is marked as failed.
Best Practices
Respond Quickly
Return
200 OK immediately, then process asynchronously. Timeout is 30 seconds.Handle Duplicates
Use
task_identifier to deduplicate. Webhooks may be delivered more than once.Use HTTPS
Always use HTTPS endpoints in production to protect webhook payloads.
Verify Signatures
Always verify the
X-FieldWise-Signature header before processing.Managing Webhooks
Configure webhooks directly in the FieldWise dashboard under Settings → Webhooks. From there you can:- Create new webhooks
- Edit webhook settings
- Delete webhooks
- Send test payloads
- Rotate secrets