---
title: "Create Subaccount"
method: POST
path: "/v4/accounts/{voip_id}/subaccounts"
tags: ["Subaccounts"]
---

# Create Subaccount

`POST /v4/accounts/{voip_id}/subaccounts`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/subaccounts`
- Auth: HTTP bearer

Add a subaccount for the authenticated user or client

## Path parameters

- `voip_id` integer, required

## Request body

- Account
  - `username` string, required: Username
  - `password` string, required: Password
  - `verification_email` string, nullable: Email verification code (if required)
  - `cc_token` string, nullable: Credit card token from Credit Card endpoint
  - `billing_day` integer, nullable: Day of account's monthly billing cycle beginning (available for special integrations only)
  - `agent_id` integer, nullable: Agent ID (available for special integrations only)
  - `tos_accept_date` integer, nullable: Timestamp of acceptance of Terms of Service. It may not be more than 1 day in the past or 1 hour in the future.
  - `tracking_data` string, nullable: Tracking data (available for special integrations only)
  - `contact` object, nullable: Contact Objects
    - `id` integer, nullable: Contact ID. Read-only
    - `name` string, required: Name
    - `company` string, nullable: Name of the contact's company
    - `address` object: Contact Address
      - `line_1` string, required: Address line 1
      - `line_2` string, nullable: Address line 2
      - `city` string, required: City
      - `province` string, nullable: Contact province
      - `postal_code` string, nullable: Contact postal code
      - `country` string, required: Country name
    - `phone` string, required: Contact phone number
    - `fax` string, nullable: Contact fax number
    - `primary_email` string, required: Primary email
    - `alternate_email` string, nullable: Alternate email
  - `billing_contact` object, nullable: Billing Contact Objects
    - `id` integer, nullable: Billing contact ID. Read-only
    - `name` string, required: Billing contact name
    - `company` string, nullable: Billing contact company
    - `address` object: Billing contact address
      - `line_1` string, required: Billing contact street address
      - `line_2` string, nullable: Billing contact street address 2
      - `city` string, required: Billing contact city
      - `province` string, nullable: Billing contact province
      - `postal_code` string, nullable: Billing contact postal code
      - `country` string, required: Billing contact country
    - `phone` string, required: Billing contact phone
    - `fax` string, nullable: Billing contact fax
    - `primary_email` string, required: Billing contact email
    - `alternate_email` string, nullable: Billing contact alternate email

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 189 revisions in range; 1 not diffed.

- **2026-10-21** `a6274ad4319c`: 1 breaking, 1 info
  - the `tos_accept_date` request property's min was increased to `1792512740.00`
  - the `tos_accept_date` request property's max was increased from `1792596635.00` to `1792602740.00`
- **2026-10-21** `531bf4c2e24b`: 1 breaking, 1 info
  - the `tos_accept_date` request property's min was increased to `1792506635.00`
  - the `tos_accept_date` request property's max was increased from `1792589185.00` to `1792596635.00`
- **2026-10-21** `47eb9b7d1cb6`: 1 breaking, 1 info
  - the `tos_accept_date` request property's min was increased to `1792499185.00`
  - the `tos_accept_date` request property's max was increased from `1792584442.00` to `1792589185.00`
- **2026-10-21** `6a06b2da42aa`: 1 breaking, 1 info
  - the `tos_accept_date` request property's min was increased to `1792494442.00`
  - the `tos_accept_date` request property's max was increased from `1792578181.00` to `1792584442.00`
- **2026-10-21** `c8e33dffe904`: 1 breaking, 1 info
  - the `tos_accept_date` request property's min was increased to `1792488181.00`
  - the `tos_accept_date` request property's max was increased from `1792573609.00` to `1792578181.00`

[Operation history](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/changes/v4/accounts/:voip_id/subaccounts/post.md)

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)