Skip to main content
Webhook notifications let your backend react to events in your Membrane workspace — connections being created, disconnected, or archived.

Setup

Configure a webhook URL in the Console under Settings > Webhook Notifications. Membrane sends a POST request to your URL whenever a matching event occurs.

Event Types

Connection Events

Flow Run Events

Alert Events

Payloads

Each webhook POST body contains an eventType field and a data object. The shape of data depends on the event category.

Connection events

Flow run events

The flowRun.failed event includes an errors array on the flow run object with details about what went wrong.

Alert events

Handling Webhooks

Example Express.js endpoint:

Retry Behavior

If your endpoint returns a non-2xx status code, Membrane retries with exponential backoff.

See Also

  • Connections — connection lifecycle and management
  • Events — data events from external apps (distinct from webhook notifications)