Skip to content

Webhook Triggers

Webhooks let external systems trigger your workflows. When an event happens elsewhere (a form submission, a new order, a repo event), that system can POST to your webhook URL to start a workflow run.

Setting Up A Webhook

  1. Open a workflow in the builder.
  2. Click the Trigger node and select Webhook.
  3. Save the workflow to generate:
  4. A Webhook URL (looks like https://<your-gloriamundo-domain>/webhook/<workflow_id>)
  5. A Secret used to sign requests

Keep the secret private.

Sending A Webhook Request

Send an HTTP POST with a JSON body to your webhook URL.

On success, GloriaMundo returns JSON including a run_id you can use to track the run in the Workflows dashboard and Action Log.

Signing Requests (Required)

GloriaMundo requires webhook requests to be signed using HMAC-SHA256 with the secret shown in the builder.

Header Options

Send the signature in one of these headers:

  • X-Webhook-Signature: <hex>
  • X-Hub-Signature-256: sha256=<hex> (GitHub-style format)

Where <hex> is the hex-encoded HMAC-SHA256 of the raw request body.

Example (Python)

import hmac, hashlib

secret = "YOUR_WEBHOOK_SECRET"
body = b'{"hello":"world"}'

signature = hmac.new(secret.encode("utf-8"), body, hashlib.sha256).hexdigest()
print(signature)

Then include it as:

X-Webhook-Signature: <signature>

Using The Payload In Your Workflow

Webhook data is provided to the workflow as trigger input. The editor and Virtual Run will show you which variables are available to reference in prompts and step configuration.

Tip: If you’re unsure of the payload shape, add an early step that logs or summarizes the payload so you can inspect it safely in Virtual Run and the Action Log.