Webhook Subscriptions

TailorTask provides a webhook system that allows external applications to receive real-time updates about specific events within your workflows. This feature enables seamless integration with third-party services, allowing you to automate actions based on workflow events.

Subscribing to Webhooks

To subscribe to webhooks, make a POST request to the following endpoint:

POST /rest/webhooks/subscribe/

Request Parameters:

• workflow_uuid (required): The UUID of the workflow you want to subscribe to.
• hookUrl (required): The URL where you want to receive webhook notifications.
• event_type (required): The type of event you want to subscribe to.

Example Request:

{
  "workflow_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "hookUrl": "<https://your-app.com/webhook-receiver>",
  "event_type": "workflow_completed"
}

Response:

{
  "message": "Webhook subscribed successfully",
  "subscription_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

Unsubscribing from Webhooks

To unsubscribe from a webhook, make a POST request to:

POST /rest/webhooks/unsubscribe/

Request Parameters:

• subscription_id (required): The UUID of the webhook subscription you want to cancel.

Example Request:

{
  "subscription_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}