Skip to main content

Setting Up Webhooks

Connect webhook endpoints to a published form so submission data is delivered automatically.

Prerequisites​

Open the Workflow Editor​

  1. Open the thread containing your published form.

  2. Click Workflows in the sidebar tab bar.

The workflow editor loads with a Form Submitted trigger node already placed on the canvas. The left sidebar shows an Actions panel and an Activity feed.

Workflow editor with the Form Submitted trigger node and no actions

Add a Webhook​

  1. Click the Webhook button in the Actions panel on the left.

A webhook node appears on the canvas, connected to the trigger node by a dashed edge.

Workflow canvas with trigger node connected to a new webhook node

Configure the Endpoint​

  1. Click the webhook node on the canvas to open the configuration panel on the right.

Webhook configuration panel showing endpoint selection and Add Endpoint button

  1. Click Add Endpoint. Fill in:
    • URL (required): the HTTPS endpoint that receives POST requests. Localhost URLs are allowed for testing.
    • Description (optional): a label to identify this endpoint.
    • Custom Headers (optional): key-value pairs sent with every delivery, such as Authorization: Bearer <token>. Values are encrypted at rest and cannot be read back after saving.

Endpoint creation form with URL, description, and custom headers fields

  1. Enter your webhook URL and an optional description, then click Add.

Endpoint form filled with a Slack webhook URL and description

Copy the Signing Secret​

  1. After creating the endpoint, a signing secret is displayed in an amber banner. Copy it immediately.
warning

The signing secret is shown only once. If you dismiss it without copying, you must rotate the secret to get a new one.

Signing secret reveal banner

  1. Click Dismiss after copying the secret.

Save and Activate​

  1. Click Save in the toolbar to persist the workflow.

  2. Toggle the Active switch in the toolbar to start delivering webhooks on new submissions.

Workflow saved with trigger connected to the Slack notification webhook

Multiple Webhooks​

To deliver submissions to more than one endpoint, click Webhook in the Actions panel again. Each new node connects to the same trigger. All endpoints receive submissions in parallel.

Editing an Endpoint​

  1. Click the webhook node to open the configuration panel.
  2. Click the pencil icon next to the endpoint you want to edit.
  3. Update the URL, description, or custom headers.
  4. Click Save.

Custom header values cannot be viewed after creation. To change them, enter new values in the edit form. The previous values are replaced entirely.

Rotating a Signing Secret​

  1. Click the webhook node to open the configuration panel.
  2. Select the endpoint.
  3. Click Rotate signing secret.

A new secret is generated and displayed. The previous secret is invalidated immediately. Update your server's verification logic with the new secret.

Monitoring and Retry​

Activity Feed​

The Activity section in the left sidebar shows recent webhook deliveries grouped by submission. It refreshes automatically every 30 seconds.

Each entry displays a status icon:

  • Success: all endpoints returned a 2xx response.
  • Failure: all endpoints failed (4xx, 5xx, timeout, or network error).
  • Partial: some endpoints succeeded and others failed.

Delivery Details​

Click an activity entry to open a detail dialog showing:

  • Timestamp and submission ID.
  • Per-endpoint status code, response time, and error message (if any).

Manual Retry​

Click the Retry button in the detail dialog to redeliver to a failed endpoint. A new delivery is created with an incremented attempt number, a fresh timestamp, and a new signature. The event ID remains the same.

Next steps​