Subscribe to trigger - Smithery Documentation

POST

connect

{namespace}

{connectionId}

.triggers

{triggerName}

Subscribe to trigger

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="
  }
}
'

{
  "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

Subscription created or refreshed

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"

Unsubscribe from triggerUnsubscribe by subscription key (params + delivery.url). Eager teardown — subscriptions also expire naturally on TTL.

⌘I

Subscribe to trigger

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="
  }
}
'

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