Use the Speak AI MCP server tool get_inbound_webhook to get an inbound webhook’s
public receive URL, captured sample payload, and the ready-to-paste
{{trigger.payload.*}} tokens for mapping payload values into automation steps
(speak-upload name/sourceUrl, fieldsMap custom-field values, notify/outbound-webhook
templates).
What does it do?
Get an inbound webhook’s public receive URL, captured sample payload, and the ready-to-paste {{trigger.payload.*}} tokens for mapping payload values into automation steps (speak-upload name/sourceUrl, fieldsMap custom-field values, notify/outbound-webhook templates). Pass either the webhookId or the automationId of an inbound-webhook automation. If no sample has been captured yet, send a test payload to the inboundUrl first (append ?test=1 to capture without running the automation).
Parameters
get_inbound_webhook takes 3 parameters, all of them optional.
| Name | Type | Required | Description |
|---|---|---|---|
webhookId |
string | No | Inbound webhook id (from provision_inbound_webhook or an automation’s trigger.webhookId) |
automationId |
string | No | Automation id: resolves the bound webhookId and childKey automatically |
childKey |
string | No | Override the dot-path used to narrow mappable payload paths (defaults to the automation’s trigger.childKey) |
Behaviour
The Speak AI MCP server publishes these behaviour hints for get_inbound_webhook.
- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Webhooks lists the rest of the Webhooks category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.