Skip to main content

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