Create organization

POST

https://api.hmsovereign.com/api/v1/organizations

Organization

Last modified:2026-01-30 13:43:45

Maintainer:Not configured

Create a new organization. If parent_org_id is provided, creates a child organization that bills to the parent (for whitelabel use cases). The API key for the new organization is only returned once at creation time.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Organization created successfully

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hmsovereign.com/api/v1/organizations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Dentist Office",
    "parent_org_id": "9721bb3f-1469-4c27-9bad-313667cb91ca"
}'

Response Example

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "parent_org_id": "9721bb3f-1469-4c27-9bad-313667cb91ca",
    "api_key": "fl_a1b2c3d4e5f6...",
    "created_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-01-30 13:43:45

Get organization information

Get organization information (deprecated)