---
title: "Create a sub-account"
method: POST
path: "/v1/sub-organizations"
tags: ["Sub-accounts"]
---

# Create a sub-account

`POST /v1/sub-organizations`

Creates a sub-account under the authenticated master account. Returns the sub-account with its generated `api_key`.

## Request body

- SubAccountsCreateRequest
  - `name` string, required — Sub-account name.
  - `default_destinations` object — Default webhook URLs for inbound messages and delivery reports.
    - `sms_endpoint` string, uri — Inbound messages webhook URL.
    - `dlr_endpoint` string, uri — Delivery report webhook URL.

## Response `200`

Returns the created sub-account.

- SubOrganizationResponse — Sub-account details including API key and webhook configurations.
  - `id` integer, required — Sub-account ID.
  - `created_at` string, date-time, required — Date and time the sub-account was created in ISO 8601 format.
  - `name` string, required — Sub-account name.
  - `api_key` string, required — Sub-account API key.
  - `master_organization` integer, required — Master account ID.
  - `status` 'enabled' | 'disabled', required — Status of the subaccount. One of `enabled` (the subaccount is active and can be used) or `disabled` (the subaccount is suspended).
  - `default_destinations` object, required — Default webhook URLs for inbound messages and delivery reports.
    - `sms_endpoint` string, uri, required — Inbound messages webhook URL.
    - `dlr_endpoint` string, uri, required — Delivery report webhook URL.

## Other responses

- `400` — Returns when a required parameter is missing or invalid.
- `403` — Request failed. The feature is disabled for your account.
- `422` — Validation error

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/versions/b22f170488b6/schema)