Skip to main content
POST
Create a specialization category

Create Specialization

Create a new provider specialization category in your organization. Requires an API key whose role permits managing providers.

Headers

Request Body

Field Descriptions

  • name (required): Display name of the specialization category. Leading and trailing whitespace is trimmed. A name that duplicates an existing active category (case-insensitive) is rejected with a 409.

Success Response (201)

Error Responses

400 - Validation Error

401 - Unauthorized

403 - Forbidden

Returned when your role does not permit managing providers.

409 - Conflict

Returned when an active category with the same name already exists (matched case-insensitively, after trimming).

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as 'Bearer '

Body

application/json
name
string
required

Display name of the specialization category. Leading/trailing whitespace is trimmed.

Minimum string length: 1

Response

Specialization created successfully

A provider specialization category. isActive is derived from soft-delete state; soft-deleted categories are returned with isActive=false.

publicId
string
required

Public identifier of the specialization category

name
string
required

Display name of the specialization category

isActive
boolean
required

Whether the category is active (not soft-deleted)