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

# Create organization

`POST /organizations`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/organizations`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/organizations/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new organization

## Request body

- object
  - `name` string: Name of the new organization
  - `ccemails` string: Comma-separated list of email addresses to CC on billing communications
  - `invoice_text` string: Custom text to include on invoices

## Response `200`

OK

- GetOrganizationResponse
  - `success` boolean: Indicates whether the request was successful.
  - `data` OrganizationObject
    - `id` integer: Unique organization ID
    - `name` string: Organization display name
    - `ownerid` integer: User ID of the organization owner
    - `is_personal` 0 | 1: 1 if this is a personal organization belonging to a single user
    - `ccemails` string: Comma-separated list of email addresses for credit card receipts
    - `proplan` 0 | 1: 1 if the organization is on a Pro plan
    - `invoice_text` string: Custom text appended to invoices
    - `preflight_timeout_in_days` integer: Number of days a SIM stays in Test Mode before automatically activating
    - `users` OrganizationUserEntry[]: Members of the organization
      - `id` integer: User ID
      - `email` string: User email
      - `first` string: First name
      - `last` string: Last name
      - `permissions` string[]: List of permissions granted to this user in the organization
    - `pending` OrganizationPendingEntry[]: Users with pending invitations
      - `email` string: Email address the invitation was sent to
      - `inviteid` integer: Invitation ID

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)