HOhookdeck
Destinations

Subscribe (MCP Events)

Changed on

Experimental. Serves the MCP Events events/subscribe method for an MCP server that forwards the request params as the body. Creates a subscription, or refreshes it when the tenant already holds the same subscription: the same tenant, event, arguments and callback URL always give the same id. A new subscription is verified with a challenge to its callback URL before it is stored; one that has expired is replaced by a new one. The tenant is created if it does not exist, even when the subscribe then fails. Admin API key only; answers 404 while MCP is not enabled (EXPERIMENTAL_MCP_ENABLED).

Failures answer 422 with an mcp_error the MCP server returns as its JSON-RPC error.

post/tenants/{tenant_id}/mcp/events/subscribe

Request

  • Base URL
    https://api.outpost.hookdeck.com/2025-07-01
  • Auth
    • HTTP bearer
    • or HTTP bearer

Request body

object required

The events/subscribe params, forwarded as received.

Example request

{
  "name": "order.created",
  "arguments": {
    "status": "paid"
  },
  "delivery": {
    "mode": "webhook",
    "url": "https://example.com/mcp-events/abc123",
    "secret": "whsec_MfKQ9r8GKYqrTwjUPD8ILPZIo2LaLaSw"
  },
  "ttlMs": 3600000
}

Response

The events/subscribe result.

resultType'complete' required
idstring required
refreshBeforestring date-time nullable required

Subscribe again before this time to keep the subscription. Null only when the request sent ttlMs: null, which means the subscription does not expire.

cursorstring nullable required

Always null; events are not replayed.

truncatedboolean required

Always false; events are not replayed.

Example response

{
  "id": "sub_3f1c2a9e5b7d4c6a8e0f1b2c3d4e5f60"
}

Changes