Skip to main content
POST
/
connect
/
{namespace}
/
{connectionId}
/
.subscriptions
Create connection subscription
curl --request POST \
  --url https://api.smithery.ai/connect/{namespace}/{connectionId}/.subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://my-app.example.com/events",
  "secret": "whsec_dGVzdF9zZWNyZXRfMjRfYnl0ZXNfbWluaW11bSE="
}
'
{
  "id": "sub_01HW1234567890",
  "url": "https://my-app.example.com/events",
  "connection_id": "notion",
  "created_at": "2026-04-22T12:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://smithery.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Smithery API key as Bearer token

Path Parameters

​
namespace
string
required
​
connectionId
string
required

Body

application/json
​
url
string<uri>
required

HTTPS webhook destination

Example:

"https://my-app.example.com/events"

​
secret
string
required

Standard Webhooks signing secret generated and stored by the receiver

Example:

"whsec_dGVzdF9zZWNyZXRfMjRfYnl0ZXNfbWluaW11bSE="

Response

Subscription created

​
id
string
required

Stable subscription id generated by Smithery

Example:

"sub_01HW1234567890"

​
url
string<uri>
required

Destination URL for webhook deliveries

Example:

"https://my-app.example.com/events"

​
connection_id
string | null
required

Connection scope. Null for namespace-wide subscriptions.

Example:

"notion"

​
created_at
string
required

ISO 8601 timestamp

Example:

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