# Webhooks MCP tools

This page documents **6 tools** in the webhooks group. Return to the [complete MCP tool reference](/docs/developers/api/mcp/tools) to browse another group.

Select a tool to inspect its schemas and behavior. Schema links open the exact definition in GitHub.

### `listWebhookSubscriptions` — List Webhook Subscriptions

List all webhook subscriptions for the organization.

- **Input:** [`ListWebhookSubscriptionsInput`](/docs)
- **Output:** [`ListWebhookSubscriptionsOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16561–L16572 ↗](/docs)

### `getWebhookSubscription` — Get Webhook Subscription

Get a webhook subscription by ID.

- **Input:** [`GetWebhookSubscriptionInput`](/docs)
- **Output:** [`GetWebhookSubscriptionOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16573–L16584 ↗](/docs)

### `createWebhookSubscription` — Create Webhook Subscription

Create a new webhook subscription for the organization. The endpoint URL must use HTTPS. Selected events determine which events trigger webhook deliveries.

- **Input:** [`CreateWebhookSubscriptionInput`](/docs)
- **Output:** [`CreateWebhookSubscriptionOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Non-idempotent · Closed world
- **Source:** [specification.yaml · L16585–L16596 ↗](/docs)

### `updateWebhookSubscription` — Update Webhook Subscription

Update a webhook subscription's endpoint URL or selected events.

- **Input:** [`UpdateWebhookSubscriptionInput`](/docs)
- **Output:** [`UpdateWebhookSubscriptionOutput`](/docs)
- **Behavior:** Writes data · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16597–L16608 ↗](/docs)

### `deleteWebhookSubscription` — Delete Webhook Subscription

Delete a webhook subscription.

- **Input:** [`DeleteWebhookSubscriptionInput`](/docs)
- **Output:** [`DeleteWebhookSubscriptionOutput`](/docs)
- **Behavior:** Writes data · Destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16609–L16620 ↗](/docs)

### `listWebhookEvents` — List Webhook Events

List webhook delivery events for a subscription. Shows delivery status (PENDING, SUCCEEDED, FAILED) and response details.

- **Input:** [`ListWebhookEventsInput`](/docs)
- **Output:** [`ListWebhookEventsOutput`](/docs)
- **Behavior:** Read only · Non-destructive · Idempotent · Closed world
- **Source:** [specification.yaml · L16621–L16632 ↗](/docs)