---
title: "Get Inbound Webhook"
description: "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)."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Inbound Webhook

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](/mcp/tools/webhooks/) lists the rest of the Webhooks category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/webhooks/get_inbound_webhook/index.mdx