Create a notification topic

POST 
/api/v1/notifications/manage/create-topic

Creates a new topic that users can be subscribed to. Topics enable broadcasting notifications to groups of subscribers.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Broadcast with topics · Push registration and topic delivery

Request

Responses

200

Topic created successfully

Create a topic before adding its subscribers.

Section ID: DOC-CP-notifications-api-createTopic#example-notifications-createTopic-request

Request example

{
  "topicKey": "product-updates",
  "name": "Product updates"
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-CP-notifications-api-createTopic#example-notifications-createTopic-response

Response example

{
  "topicKey": "example_123",
  "topicId": "example_123"
}

Document ID: DOC-CP-notifications-api-createTopic. Section identities and revisions.

Section	Stable reference
Create a notification topic	DOC-CP-notifications-api-createTopic#overview
Request	DOC-CP-notifications-api-createTopic#request
Responses	DOC-CP-notifications-api-createTopic#responses