---
title: "Create Account"
method: POST
path: "/v1/accounts"
tags: ["Reseller"]
---

# Create Account

`POST /v1/accounts`

Create a new account under the reseller associated with the supplied API credential.

## Request body

- AccountCreationParameters — Create Account
  - `name` string, required — Name of the account to be created
  - `subdomain` string, required — Subdomain this account will use to access the Huntress portal
  - `phone_number` string, required — Primary phone number used to contact account owner
  - `admin` object, required
    - `first_name` string, required — First name of the initial admin user for this account
    - `last_name` string, required — Last name of the initial admin user for this account
    - `email` string, required — Email address of the initial admin user for this account
  - `additional_admin_emails` string[] — Email addresses of additional admin users to invite to this account
  - `support_type` 'huntress_supported' | 'partner_supported' — Specifies whether a reseller account is managed by the partner or by Huntress. NOTE: This field is only required for Managed Resellers. For all other types of resellers, there is only one valid support type, so it will be selected automatically.
  - `products` string[] — A list of the products to provision for this account. NOTE: This field is only relevant for Aggregators. For all other types of resellers, the appropriate trials will be created automatically and this field will be ignored. (If you aren't sure whether this applies to you, you can probably ignore this field.)
  - `product_trials` string[] — A list of the products that should receive trials for this account. Only applies to trial-supporting resellers (this field is ignored for Aggregators). If omitted, trials are started for every product enabled for the reseller. If supplied, must include at least one product, and each listed product must be enabled for the reseller.
  - `product_trials_start_date` string — The date that the trials in product_trials should start in ISO-8601 format (YYYY-MM-DD). Only applies if product_trials are provided. If product_trials are provided and product_trials_start_date is left blank, trials will start today. The date is assumed to be in the API caller's time zone.
  - `billing_address` object — Billing address for the account. If provided, must be valid.
    - `line1` string — Street address line 1
    - `line2` string — Street address line 2
    - `city` string — City
    - `state` string — State or province (required for US and CA)
    - `postal_code` string — Postal or ZIP code (required for US and GB)
    - `country` string — Two-letter ISO 3166-1 alpha-2 country code
  - `shipping_address` object — Shipping address for the account. If provided, must be valid.
    - `line1` string — Street address line 1
    - `line2` string — Street address line 2
    - `city` string — City
    - `state` string — State or province (required for US and CA)
    - `postal_code` string — Postal or ZIP code (required for US and GB)
    - `country` string — Two-letter ISO 3166-1 alpha-2 country code

## Response `201`

Create Account

- object
  - `account` Account — Account model
    - `id` integer — A unique identifier for the account.
    - `name` string — The public facing display name for the account.
    - `subdomain` string — The subdomain for the account.
    - `status` 'enabled' | 'disabled' — The current status of the account.
    - `support_type` 'huntress_supported' | 'partner_supported' | 'not_applicable' — For accounts that have been provisioned through a reseller, this field indicates whether the account is huntress supported or partner supported.
    - `neighborhood_watch` unknown
    - `billing_address` Address
      - `line1` string — Street address line 1.
      - `line2` string — Street address line 2.
      - `city` string — City.
      - `state` string — State or province. Required for US and CA addresses.
      - `postal_code` string — Postal or ZIP code. Required for US and GB addresses.
      - `country` string — Two-letter ISO 3166-1 alpha-2 country code.
    - `shipping_address` Address
      - `line1` string — Street address line 1.
      - `line2` string — Street address line 2.
      - `city` string — City.
      - `state` string — State or province. Required for US and CA addresses.
      - `postal_code` string — Postal or ZIP code. Required for US and GB addresses.
      - `country` string — Two-letter ISO 3166-1 alpha-2 country code.

## Other responses

- `400` — Invalid account creation parameters
- `403` — There was an issue with your API credential or permissions.
- `409` — Something about the state of this reseller prevents this account from being created
- `422` — Could not create account

---

[API](https://skmtc.net/huntress/apis/huntress-api-reference.md) · [All operations](https://skmtc.net/huntress/apis/huntress-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huntress/huntress-api-reference/revisions/94acb422c07d/schema)