Webhooks allow your systems to receive real-time notifications when specific events occur within our platform. This feature is currently in early access and supports one event type, with more to come.
⚙️ To set up webhooks, please contact our support team at [email protected]. Configuration is currently not available in the UI.
🌐 What are webhooks?
Webhooks let you subscribe to platform events and receive a POST request with structured data when those events happen. They’re ideal for:
Triggering external workflows
Syncing with third-party tools
Logging or auditing activity
📘 Supported event types
Currently, we support one event type:
subprocess_entity.completed - triggered when a subprocess entity reaches the Completed status (does not include "Approved" or "Rejected" statuses)
🔎 If the event type you are looking for is not in the list, contact us, we may be able to add it for you.
📦 What’s in the HTTP Request?
Each webhook HTTP request includes:
JSON body:
{
"event": "event_type",
"data": {} // specific event_type payload,
"delivery_key": "unique_event_delivery_key",
}Headers:
X-Request-ID: Unique HTTP request ID
X-Webhook-Retry: Retry count (starts at 0)
X-Webhook-Delivery: Unique event delivery key (consistent across retries)
X-Webhook-Event: Event type
X-Webhook-Signature: Signature for verifying authenticity
X-Webhook-Timestamp: Unix timestamp of the request sent
User-Agent: Daymi Webhook Sender/1.0
in addition custom headers can be added per client request
🔁 Delivery & Retry Logic
Webhooks are sent once, but if the target endpoint fails to respond (e.g. timeout or 5xx error), we’ll retry the delivery:
Attempt | Description |
1st | Initial attempt |
2nd | Retry with back-off |
3rd | Final retry with back-off |
Retries use exponential back-off to minimize load and reduce retry storms.
💡 Use the delivery_key to identify and deduplicate events.
🔧 Configuration & Setup
Webhook configuration is currently manual and handled by our team. If you’re interested in using webhooks:
➡️ Please contact support, and we’ll help you:
Register your webhook endpoints
Validate setup and test your integration