Sign in
latestSwagger 2.02026-08-109450223.9 KB

94acb422c07d

Reseller

Create Account

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

post/v1/accounts

Request body

namestring required

Name of the account to be created

subdomainstring required

Subdomain this account will use to access the Huntress portal

phone_numberstring required

Primary phone number used to contact account owner

additional_admin_emailsstring[]

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.

productsstring[]

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_trialsstring[]

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_datestring

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.

Example request

{
  "additional_admin_emails": [
    "another_admin@example.com",
    "one_more@example.com"
  ],
  "products": [
    "edr",
    "ispm",
    "itdr",
    "sat",
    "siem"
  ],
  "product_trials": [
    "edr",
    "ispm",
    "itdr",
    "sat",
    "siem"
  ]
}

Response

Create Account

Example response

{
  "account": {
    "id": 1,
    "name": "Your Account",
    "subdomain": "exampleaccount",
    "status": "enabled",
    "support_type": "huntress_supported",
    "neighborhood_watch": {
      "edr": 10,
      "ispm": 10,
      "itdr": 10,
      "sat": 10,
      "siem": 10
    }
  }
}