---
title: "Create Organization"
method: POST
path: "/platform/organizations"
---

# Create Organization

`POST /platform/organizations`

Creates a new organization for a platform tenant. Reuses existing users and organizations if they already exist.

## Request body

- CreateOrganizationRequest
  - `user_email` string, email, required — Email address of the organization owner. User will be created if it doesn't exist.
  - `name` string, required — Display name for the organization.
  - `slug` string, required — Unique slug for the organization.
  - `env` 'test' | 'live' | 'both' — Environment(s) to create API keys for.

## Response `201`

Organization created successfully

- CreateOrganizationResponse
  - `test_secret_key` string, nullable — Autumn test API key for the organization (if env is 'test' or 'both').
  - `live_secret_key` string, nullable — Autumn live API key for the organization (if env is 'live' or 'both').

## Other responses

- `400` — Invalid request parameters
- `403` — Platform feature not enabled

---

[API](https://skmtc.net/useautumn/apis/autumn-api.md) · [All operations](https://skmtc.net/useautumn/apis/autumn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useautumn/autumn-api/versions/29536933c0dc/schema)