Webhooks
Creating webhooks, all supported event types, payload format, signature verification, and retry logic.
Overview
Webhooks allow PlugIQ to push real-time event notifications to your server whenever something happens in your workspace. Use webhooks to trigger downstream automation, sync data to external databases, or build integrations without polling the API.
Event Types
record.created— a new submission was made.record.approved— a stage was approved.record.rejected— a stage was rejected.record.completed— the record reached a final state.record.escalated— an SLA breach caused an escalation.record.reassigned— an approver was reassigned.
Signature Verification
Each request includes an X-PlugIQ-Signature header containing an HMAC-SHA256 signature of the payload using your webhook secret. Always verify this signature before processing the payload.
Retry Logic
If your endpoint returns a non-2xx response, PlugIQ retries delivery with exponential backoff: after 1 minute, 5 minutes, 30 minutes, 2 hours, and 12 hours. After five failed attempts, the event is marked as failed and can be manually retried.