Webhooks

Send and receive webhook events for custom integrations.

Outgoing webhooks#

LumenFlow can send HTTP POST requests when events occur in your workspace.

Configuring outgoing webhooks#

  1. Go to Settings → Connections → Webhooks
  2. Click Add Webhook
  3. Enter the destination URL
  4. Select which events to send
  5. Optionally add a signing secret

Event payload#

Each webhook delivery includes the event type, your workspace identifier, a timestamp, and the relevant action details (such as action type, status, and token usage).

Webhook signing#

When you provide a signing secret, LumenFlow includes an X-LumenFlow-Signature header with each request. Verify this signature to ensure the webhook is authentic.

Incoming webhooks#

Receive data from external services via a unique webhook URL:

  1. Go to Settings → Connections → Webhooks
  2. Click Create Incoming Webhook
  3. Copy the generated URL
  4. Configure the external service to POST to this URL

Incoming webhook data is delivered to Sidekick as a message, which can trigger workflows and governance rules.

warning Incoming webhook URLs should be treated as secrets. Anyone with the URL can send data to your workspace.