SMsmithery-ai
connect

Create connection subscription

Changed on

Create a connection-scoped subscription that receives events from one connection.

post/connect/{namespace}/{connectionId}/.subscriptions

Request

  • Base URL
    https://api.smithery.ai
  • URL
    https://api.smithery.ai/connect/{namespace}/{connectionId}/.subscriptions
  • Auth
    HTTP bearer

Path parameters

namespacestring required
connectionIdstring required

Response

Subscription created

idstring required

Stable subscription id generated by Smithery

urlstring uri required

Destination URL for webhook deliveries

connection_idstring nullable required

Connection scope. Null for namespace-wide subscriptions.

created_atstring required

ISO 8601 timestamp

secretstring required

Webhook signing secret. Returned only once at creation time.

Example response

{
  "id": "sub_01HW1234567890",
  "url": "https://my-app.example.com/events",
  "connection_id": "notion",
  "created_at": "2026-04-22T12:00:00.000Z",
  "secret": "whsec_0123456789abcdef"
}

Changes