Webhooks in Hystruct allow you to receive real-time notifications about events that occur in your account. You can subscribe to specific events, such as when a workflow is completed or data is updated, and receive a POST request to your specified URL when the event is triggered.

Steps to Subscribe to Webhook Events

You can create a new webhook subscription either from the Hystruct dashboard, or by using the Hystruct API. Read more about managing webhooks using the API in the API Reference.

To create a webhook subscription from the dashboard:

  1. Login to the Hystruct dashboard and navigate to the “Integrations” page.

  2. Click on “Webhooks” on the left, and then on “Create webhook”.

  3. Fill in the form with the required details:

    • Webhook URL: The URL where you want the webhook events to be sent.
    • Events: Select the events you wish to subscribe to.
    • Workflow ID (optional): If you want to subscribe to events for a specific workflow, enter the workflow ID here.

Handling Incoming Webhook Events

When a subscribed event is triggered, Hystruct sends a POST request to your specified webhookUrl with the event details. The payload includes information about the event, such as the workflowId and other relevant data.

Unsubscribing from Webhook Events

If you no longer want to receive notifications for a specific event, you can unsubscribe from the event by deleting the webhook subscription. You can do this from the Hystruct dashboard or by using the API. Read more about deleting webhooks using the API in the API Reference.