Connections

Setting Up a Webhook

Setting up a webhook takes about 60 seconds: create it in Commander, copy the URL, paste it into your external service, and send a test event.

WebhooksSetup
Last updated: March 2, 20264 min read

Overview

Setting up a webhook takes about 60 seconds: create it in Commander, copy the URL, paste it into your external service, and send a test event.

Creating a Webhook Connection

In Commander (UI)

  1. Open your Connection Canvas (Connections tool in your workspace)
  2. Click the "+" button and select Webhook
  3. Give it a descriptive name (e.g., "Stripe Payments", "HubSpot Contacts", "Contact Form")
  4. Your webhook URL and token are generated automatically

Via CLI (Claude Code / Terminal)

waymaker connections webhook create \
  --title "Contact Form" \
  --workspace <workspace-id> \
  --table <destination-table-id>

The CLI returns the webhook URL and token. See AI Agent Setup for full CLI/MCP connection tools.

Via MCP (Claude Desktop / Cursor)

Use the commander_connection_create tool with connection_type: "webhook". The webhook URL is auto-generated.

Copying the URL

Your webhook URL appears in the connection detail panel. Click the copy button to copy the full URL to your clipboard:

https://apps.waymakerone.com/functions/v1/connection-webhook-receiver?connection_id=YOUR_ID&token=whk_xxxxx

The URL includes a unique connection_id and token that authenticate incoming requests. Keep this URL private.

Where to Paste

Paste your webhook URL into the external service's webhook configuration. Here's where to find it in popular services:

ServiceWhere to Configure
HubSpotSettings > Account Setup > Integrations > Webhooks
SalesforceSetup > Platform Events or Outbound Messages
StripeDevelopers > Webhooks > Add endpoint
XeroDeveloper portal > My Apps > Webhooks
QuickBooksDeveloper portal > Webhooks > Subscribe
Zapier"Webhooks by Zapier" action > POST
MakeHTTP module > Make a request > POST
GitHubRepo > Settings > Webhooks > Add webhook

Don't see your service? Browse all 380+ webhook integrations with setup guides by category.

Sending a Test Event

Using the Test Button

Click Send Test Event in your connection's detail panel. This sends a sample payload to your webhook URL so you can verify it's working before connecting your real service.

Using cURL

You can also test from your terminal:

curl -X POST "YOUR_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "message": "Hello from cURL"}'

Requirements

Any request to your webhook URL must be:

  • Method: POST
  • Content-Type: application/json
  • Body: Valid JSON payload

Verifying It Works

After sending a test event:

  1. Open your connection's Events tab
  2. You should see the event with a green OK status badge
  3. Click the event to expand it and see the full payload

If you see a red Error badge instead, expand the event to see the error message and check the Event Log guide for troubleshooting.

What's Next