---
title: "Create Subaccount."
method: POST
path: "/subaccounts"
tags: ["subaccounts"]
---

# Create Subaccount.

`POST /subaccounts`

Create subaccount.

## Request body

- SubaccountCreateRequest
  - `email` string, email, required
  - `ip` string, required — IP address to use for sending emails.
  - `first_name` string, required — subaccount owner first name
  - `last_name` string, required — subaccount owner last name
  - `address_1` string, nullable — Address Line 1
  - `address_2` string, nullable — Address Line 2
  - `city` string, nullable — City
  - `company_name` string, nullable — Agency Name
  - `country` string, nullable — Country
  - `region` string, nullable — Region
  - `zip_code` string, nullable — Zip Code
  - `phone_number` string, nullable — Phone Number
  - `policy_agree` boolean, required — Policy must be agreed in order to be able to create a subaccount.
  - `site_url` string, nullable — Website
  - `password` string, required — subaccount password
  - `confirm_password` string, required — subaccount confirm password

## Response `201`

Sub account details.

- Subaccount
  - `email` string, email, required
  - `ip` string — IP address to use for sending emails.
  - `active` boolean, required — Active subaccounts can be used for login purpose, while users can´t login to inactive subaccounts. Notice that in order to be able to send emails the subaccount subscription must also be active. User can set subaccounts to active / inactive from the dashboard.
  - `subaccount_id` integer — Sub account Id
  - `parent_id` integer — Sub account parent Id
  - `first_name` string — subaccount owner first name
  - `last_name` string — subaccount owner last name
  - `address_1` string, nullable — Address Line 1
  - `address_2` string, nullable — Address Line 2
  - `city` string, nullable — City
  - `company_name` string, nullable — Agency Name
  - `country` string, nullable — Country
  - `region` string, nullable — Region
  - `zip_code` string, nullable — Zip Code
  - `phone_number` string, nullable — Phone Number
  - `policy_agree` boolean — Policy must be agreed in order to be able to create a subaccount.
  - `site_url` string, nullable — Website

## Other responses

- `400` — Bad Request ###### Produces: * email_is_already_in_use * missing_required_parameter_email * missing_required_parameter_first_name * missing_required_parameter_last_name * missing_required_parameter_password * password_length_should_not_be_less_than_10_characters * password_should_contain_at_least_one_uppercase_character * password_should_contain_at_least_one_digit * missing_required_parameter_confirm_password * password_should_equal_confirm_password * missing_required_parameter_ip * ip_should_be_IPV4_format * ip_not_associated_to_user_account * policy_agree_should_be_true
- `401` — Unauthorized This API requires a valid API Key to be provided. (Use [/authentication/authorize](#/authentication/AuthenticationLogin) to obtain an API Key) Produces: * missing_authorization_key * invalid_authorization_key * account_is_inactive
- `403` — Forbidden The current active plan does not include this feature, upgrade is required to use this feature.

---

[API](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis.md) · [All operations](https://skmtc.net/serversmtp/apis/turbosmtp-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serversmtp/turbosmtp-public-apis/revisions/8503e099b215/schema)