---
title: "Create an Organization"
method: POST
path: "/v1/accounts/{account_id}/organizations"
tags: ["Reseller"]
---

# Create an Organization

`POST /v1/accounts/{account_id}/organizations`

## Path parameters

- `account_id` integer, required

## Request body

- OrganizationCreationParameters — Create an Organization
  - `name` string, required — The name of the organization. Value cannot be blank and must be 256 characters or less.
  - `key` string, required — Organization keys are used to associate a Huntress Agent into a grouping. Value cannot be blank and must be 256 characters or less.

## Response `201`

Create an Organization

- object
  - `organization` Organization — Organization model
    - `id` integer — A Huntress-unique identifier for the organization.
    - `agents_count` integer — Number of all agents for the organization.
    - `account_id` integer — The unique identifier of the account associated with the organization.
    - `created_at` string, date-time — A timestamp for when the organization was created, formatted as per ISO-8601.
    - `incident_reports_count` integer — Number of incident reports for the organization.
    - `key` string — The subdomain associated with the organization.
    - `logs_sources_count` integer — Number of SIEM log sources that are billable and eligible for billing.
    - `identity_provider_tenant_id` string — The Identity Provider Tenant ID associated with the organization
    - `billable_identity_count` integer — Number of billable identities for the organization.
    - `name` string — The public facing name for this organization.
    - `report_recipients` string[] — A list of emails Huntress is configured to send notification emails for the organization.
    - `sat_learner_count` integer — Number of SAT learners.
    - `updated_at` string, date-time — A timestamp for when the organization was updated, formatted as per ISO-8601.

## Other responses

- `400` — Something about the request is malformed.
- `403` — There was an issue with your API credential or permissions.
- `422` — Invalid creation parameters.

---

[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)