---
title: "Subscribe to trigger"
method: POST
path: "/{namespace}/{connectionId}/.triggers/{triggerName}"
tags: ["connect"]
---

# Subscribe to trigger

`POST /{namespace}/{connectionId}/.triggers/{triggerName}`

Subscribe to (or refresh) a trigger. Supplying the same (params, delivery.url) refreshes the TTL and may rotate the secret.

## Path parameters

- `namespace` string, required
- `connectionId` string, required
- `triggerName` string, required

## Request body

- CreateTriggerRequest
  - `params` LooseObject, required
  - `delivery` TriggerDelivery, required
    - `url` string, required — HTTPS webhook destination where the upstream MCP server delivers events.
    - `secret` string, required — Standard Webhooks signing secret (whsec_<base64 of 24-64 random bytes>). The upstream MCP server signs each delivery with this.

## Response `200`

Subscription created or refreshed

- TriggerSubscription
  - `id` string, required — Stable subscription id derived from (namespace, connection, name, params, delivery.url). Used by the receiver to route via X-MCP-Subscription-Id.
  - `refreshBefore` string, required — ISO 8601 timestamp at which the subscription expires unless refreshed.

## Other responses

- `400` — Validation error
- `404` — Connection or trigger not found

---

[API](https://skmtc.net/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.net/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/revisions/60b8c3d2fecf/schema)