---
title: "Create namespace subscription"
method: POST
path: "/connect/{namespace}/.subscriptions"
tags: ["connect"]
---

# Create namespace subscription

`POST /connect/{namespace}/.subscriptions`

## Request

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

Create a namespace-scoped subscription that receives events from every connection in the namespace.

## Path parameters

- `namespace` string, required

## Response `200`

Subscription created

- CreateSubscriptionResponse
  - `id` string, required: Stable subscription id generated by Smithery
  - `url` string, uri, required: Destination URL for webhook deliveries
  - `connection_id` string, nullable, required: Connection scope. Null for namespace-wide subscriptions.
  - `created_at` string, required: ISO 8601 timestamp
  - `secret` string, required: Webhook signing secret. Returned only once at creation time.

## Other responses

- `400`: Validation error

## Changes

- **2026-10-16** `17463ce9a13a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/connect/:namespace/.subscriptions/post.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) - [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/17463ce9a13a?raw)