Subscribe to trigger

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

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

Subscribe to trigger

cURL

curl --request POST \
  --url https://api.smithery.ai/connect/{namespace}/{connectionId}/.triggers/{triggerName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "params": {},
  "delivery": {
    "url": "https://my-app.example.com/events",
    "secret": "whsec_dGVzdF9zZWNyZXRfMjRfYnl0ZXNfbWluaW11bSE="
  }
}
'

200

{
  "id": "trg_01HW1234567890",
  "refreshBefore": "2026-04-22T13:00:00.000Z"
}

Authorizations

Authorization · string · header · required

Smithery API key as Bearer token

Path Parameters

namespace · string · required

connectionId · string · required

triggerName · string · required

Body

application/json

params · object · required

Trigger-specific parameters defined by the trigger inputSchema

Show child attributes

delivery · object · required

Show child attributes

Response

200

application/json

Subscription created or refreshed

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.

Example:

"trg_01HW1234567890"

refreshBefore · string · required

ISO 8601 timestamp at which the subscription expires unless refreshed.

Example:

"2026-04-22T13:00:00.000Z"