---
title: "Create a team account"
method: POST
path: "/accounts"
---

# Create a team account

`POST /accounts`

## Request

- Base URL: `https://rendry.io/api/v1`
- URL: `https://rendry.io/api/v1/accounts`
- Auth: HTTP bearer

## Headers

- `X-Rendry-Account` string

## Request body

- object
  - `name` string, required

## Response `201`

Create a team account

- Account
  - `id` string, required
  - `kind` 'personal' | 'team', required
  - `name` string, required
  - `role` 'owner' | 'admin' | 'editor' | 'viewer'
  - `created_at` string, date-time, required

## Other responses

- `400`: Typed refusal with a stable error code.
- `401`: Typed refusal with a stable error code.
- `403`: Typed refusal with a stable error code.
- `404`: Typed refusal with a stable error code.
- `409`: Typed refusal with a stable error code.
- `429`: Typed refusal with a stable error code.

---

[API](https://skmtc.dev/rendry/apis/rendry-api.md) · [All operations](https://skmtc.dev/rendry/apis/rendry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rendry/apis/rendry-api/revisions/c4fb572c26c9?raw)