---
title: "Create or refresh an MCP Events webhook subscription"
method: POST
path: "/api/v1/mcp-events/subscribe"
---

# Create or refresh an MCP Events webhook subscription

`POST /api/v1/mcp-events/subscribe`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/kenn-io/apis/kata/docs/api/v1/mcp-events/subscribe/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- MCPEventsSubscribeBody
  - `arguments` MCPEventsArguments, required
    - `all_projects` boolean
    - `for` string, required
    - `issue_uid` string
    - `project_uids` string[]
  - `delivery` MCPEventsDelivery, required
    - `mode` string, required
    - `secret` string
    - `url` string, required
  - `forwarder_scope` MCPEventsForwarderScope
    - `all` boolean
    - `projects` string[]
  - `name` string, required
  - `no_expiry` boolean
  - `ttl_ms` integer

## Response `200`

OK

- MCPEventsSubscribeResponseBody
  - `delivery_status` MCPEventsDeliveryStatus, required
    - `active` boolean, required
    - `failed_since` string, date-time
    - `last_delivery_at` string, date-time
    - `last_error` string
  - `id` string, required
  - `refresh_before` string, date-time, nullable, required

## Other responses

- `default`: Error

## Changes

- **2026-11-08** `a997791c4811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/mcp-events/subscribe/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) - [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/f9c29d9b41e3?raw)