Creates a new notification category. The category is created in unpublished state. Publish the category to make it available for subscriptions.
CreateCategoryDto
Created
Represents a notification category that can be used to organize and filter notifications.
Gets or sets the description of the category.
Gets or sets a value indicating whether recipients can opt out of notifications in this category.
Gets or sets the current status of the category.
Gets or sets an optional note about the category.
Gets or sets a value indicating whether this category can be deleted.
Gets or sets the number of messages sent in the current month.
Gets or sets the number of messages sent today.
Gets or sets the number of messages sent in the current week.
Gets or sets the timestamp of when this category was last used to send a notification.
Gets or sets a value indicating whether this category is enabled by default for new recipients.
Bad Request
POST /public/v1/notifications/categories HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 116
{
"name": "text",
"description": "text",
"optOutAllowed": true,
"note": "text",
"deleteAllowed": true,
"enabledByDefault": true
}{
"id": "text",
"audit": {
"created": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"updated": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"published": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"unpublished": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
},
"deleted": {
"at": "2026-01-01T00:00:00.000Z",
"by": {
"id": "text",
"name": "text",
"icon": "text",
"revision": 1
}
}
},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"revision": 1,
"description": "text",
"optOutAllowed": true,
"status": "text",
"note": "text",
"deleteAllowed": true,
"statistics": {
"month": 1,
"today": 1,
"week": 1
},
"lastUsed": "2026-01-01T00:00:00.000Z",
"enabledByDefault": true
}