Skip to main content

Webhooks

Written by Kestutis Vansavicius

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

Did this answer your question?