Skip to content

list_webhook_endpoints

List the webhook endpoints and what they subscribe to.

Authentication required

Endpoint

endpoint
https://business.sessions.website/@<handle>/api/mcp

When to use it

  • When an integration has stopped receiving events and you are working out whether the endpoint is even enabled.

  • Before webhook_deliveries, to get the endpoint id it can scope to.

Parameters

limitnumberoptional

Max endpoints (default 25).

Returns

Each endpoint with its URL, whether it is enabled, and the event types it subscribes to.

Example

POST this to the endpoint above.

JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_webhook_endpoints",
    "arguments": {
      "limit": 25
    }
  }
}
content
2 endpoint(s):
- https://example.com/hooks [<id>] · enabled ·
  registration.created, registration.cancelled

What the agent is told

The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.

list_webhook_endpoints
List the business's webhook endpoints with URL, enabled/disabled status, and subscribed event types. Use webhook_deliveries to inspect recent delivery attempts and failures for an endpoint.

See also