---
title: "Create a new managed account."
method: POST
path: "/managed_accounts"
tags: ["Managed Accounts"]
---

# Create a new managed account.

`POST /managed_accounts`

Create a new managed account owned by the authenticated user. You need to be explictly approved by Telnyx in order to become a manager account.

## Request body

- CreateManagedAccountRequest
  - `email` string — The email address for the managed account. If not provided, the email address will be generated based on the email address of the manager account.
  - `password` string — Password for the managed account. If a password is not supplied, the account will not be able to be signed into directly. (A password reset may still be performed later to enable sign-in via password.)
  - `business_name` string, required — The name of the business for which the new managed account is being created, that will be used as the managed accounts's organization's name.
  - `managed_account_allow_custom_pricing` boolean — Boolean value that indicates if the managed account is able to have custom pricing set for it or not. If false, uses the pricing of the manager account. Defaults to false. This value may be changed after creation, but there may be time lag between when the value is changed and pricing changes take effect.
  - `rollup_billing` boolean — Boolean value that indicates if the billing information and charges to the managed account "roll up" to the manager account. If true, the managed account will not have its own balance and will use the shared balance with the manager account. This value cannot be changed after account creation without going through Telnyx support as changes require manual updates to the account ledger. Defaults to false.

## Response `200`

Successful response with information about a single managed account.

- object
  - `data` ManagedAccount
    - `record_type` 'managed_account', required — Identifies the type of the resource.
    - `id` string, uuid, required — Uniquely identifies the managed account.
    - `email` string, email, required — The managed account's email.
    - `api_key` string, required — The managed account's V2 API access key
    - `api_user` string, required — The manager account's email, which serves as the V1 API user identifier
    - `api_token` string, required — The managed account's V1 API token
    - `organization_name` string — The organization the managed account is associated with.
    - `manager_account_id` string, required — The ID of the manager account associated with the managed account.
    - `balance` ManagedAccountBalance
      - `record_type` 'balance' — Identifies the type of the resource.
      - `balance` string — The account's current balance.
      - `credit_limit` string — The account's credit limit.
      - `available_credit` string — Available amount to spend (balance + credit limit)
      - `currency` string — The ISO 4217 currency identifier.
    - `created_at` string, required — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string, required — ISO 8601 formatted date indicating when the resource was updated.
    - `managed_account_allow_custom_pricing` boolean — Boolean value that indicates if the managed account is able to have custom pricing set for it or not. If false, uses the pricing of the manager account. Defaults to false. There may be time lag between when the value is changed and pricing changes take effect.
    - `rollup_billing` boolean — Boolean value that indicates if the billing information and charges to the managed account "roll up" to the manager account. If true, the managed account will not have its own balance and will use the shared balance with the manager account. This value cannot be changed after account creation without going through Telnyx support as changes require manual updates to the account ledger. Defaults to false.

## Other responses

- `401` — Unauthenticated response. Happens when the current user cannot be authenticated.
- `422` — Unprocessable entity. Check the 'detail' field in response for details.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)