Integrations

Webhooks

Webhooks are the most powerful way to trigger riogentix workflows in real time from external systems.

Your Webhook URL

Every workflow with a Webhook Trigger gets a unique URL:

https://<tenant>.riogentix.com/webhook/<workflow-id>

Find it in the trigger node's configuration panel.

Making a Webhook Request

curl -X POST https://<tenant>.riogentix.com/webhook/abc123 \
  -H "Content-Type: application/json" \
  -H "X-Riogentix-Token: your-secret-token" \
  -d '{"event": "payment.received", "amount": 9900, "currency": "EUR"}'

Supported Methods

GET — query parameters are available as $json.query
POST — body is available as $json
PUT, PATCH, DELETE — also supported

Authentication

Method	How
None	Leave auth blank (only for trusted internal systems)
Token	Add header `X-Riogentix-Token: <secret>`
Basic Auth	Include `Authorization: Basic <base64>`
HMAC SHA-256	Verify signature in a Code node

Responding to Webhooks

By default, riogentix responds immediately with 200 OK and processes the workflow asynchronously.

To return a custom response (e.g., for synchronous workflows):

Enable "Respond with workflow data" in the trigger settings
Add a Respond to Webhook node at the end of the workflow
Set the status code, headers, and body

Testing Webhooks Locally

Use a tunnelling tool during development:

# ngrok example
ngrok http 5173
# Then use the ngrok URL as your webhook target