Skip to main content

Webhooks

Webhooks are HTTP endpoints that trigger your workflows when called.

Creating a Webhook​

  1. Drag a Webhook Trigger node onto your workflow canvas
  2. Configure settings (allowed methods, authentication)
  3. Save your workflow — webhook URL is generated automatically

Webhook URL​

https://api.flowmaestro.ai/webhooks/{workflowId}

Request Handling​

// Body (for POST/PUT/PATCH)
{
    {
        trigger.body;
    }
}
{
    {
        trigger.body.fieldName;
    }
}

// Query parameters
{
    {
        trigger.query.paramName;
    }
}

// Headers
{
    {
        trigger.headers.authorization;
    }
}

Authentication​

API Key​

curl -X POST https://api.flowmaestro.ai/webhooks/xxx \
  -H "X-API-Key: your-webhook-key"

Signature Verification​

Verify webhook authenticity with HMAC signatures.

Testing​

curl -X POST https://api.flowmaestro.ai/webhooks/xxx \
  -H "Content-Type: application/json" \
  -d '{"test": "data"}'