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.
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)
- Open your Connection Canvas (Connections tool in your workspace)
- Click the "+" button and select Webhook
- Give it a descriptive name (e.g., "Stripe Payments", "HubSpot Contacts", "Contact Form")
- 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:
| Service | Where to Configure |
|---|---|
| HubSpot | Settings > Account Setup > Integrations > Webhooks |
| Salesforce | Setup > Platform Events or Outbound Messages |
| Stripe | Developers > Webhooks > Add endpoint |
| Xero | Developer portal > My Apps > Webhooks |
| QuickBooks | Developer portal > Webhooks > Subscribe |
| Zapier | "Webhooks by Zapier" action > POST |
| Make | HTTP module > Make a request > POST |
| GitHub | Repo > 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:
- Open your connection's Events tab
- You should see the event with a green OK status badge
- 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
- Map fields to a table — Route incoming data into your Commander Tables automatically
- Set up alerts — Get notified if errors start occurring
- Add HMAC security — Verify webhook signatures for Stripe, GitHub, Shopify