---
title: "Create a customer organization"
method: POST
path: "/customer-organizations"
tags: ["Organizations"]
---

# Create a customer organization

`POST /customer-organizations`

Create a customer organization to manage parent-child relationships for your [customers](/customers/overview).

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Request body

- CustomerOrganizationRequest
  - `ownerId` string, required — ID of the customer that will own the organization.
  - `memberIds` string[], required — IDs of the customers who are members of this organization, excluding the owner. These are the children in a parent-child relationship. You can pass an empty array if they are not yet known.

## Response `201`

Created

- CustomerOrganization
  - `id` string, required — Organization ID
  - `owner` CustomerIdWithName, required — ID of the customer that will own the organization.
    - `id` string, required — Customer ID
    - `name` string, required — Customer legal name
  - `members` CustomerIdWithName[], required — Members of the customer organization, excluding the owner. These are the children in a parent-child relationship.
    - `id` string, required — Customer ID
    - `name` string, required — Customer legal name

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/sequencehq/apis/sequence.md) · [All operations](https://skmtc.net/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequencehq/sequence/versions/cae64b02699f/schema)