Create an account

Creates a new account owned by the caller’s user. The caller becomes a member with the account_admin, billing_admin, and developer roles. Any member role may call it.

The number of accounts a user may administer is capped (5 by default). Your first, personal account does not count toward the cap. Accounts created here do not receive a signup credit gift; add funds before running sessions.

The calling API key stays bound to its original account. To work in the new account, create an API key there.

To make retries safe, send an idempotency_key. Retries with the same key and the same name return the same account, even at the cap. Without a key, every request creates a new account. A slug in the body is rejected; set it later with PATCH /accounts/{account_id}.

POST

accounts

curl --request POST \
  --url https://api.reactor.inc/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Inc"
}
'

{
  "id": "8d478ca2-2222-4444-9999-123456789abc",
  "name": "Acme Inc",
  "billing_email": "alice@acme.example",
  "plan_id": "2a7d9c1e-6b5f-4e3d-8c2b-1a0f9e8d7c6b",
  "plan": {
    "id": "2a7d9c1e-6b5f-4e3d-8c2b-1a0f9e8d7c6b",
    "slug": "free",
    "name": "Free",
    "kind": "standard"
  },
  "billing": {
    "postpay": false,
    "converting_to_usd": false
  },
  "created_at": "2026-11-10T09:30:00Z",
  "updated_at": "2026-11-10T09:30:00Z"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "team account limit reached"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Body

application/json

name

string

required

The display name. Must not be blank. Names need not be unique.

idempotency_key

string

Optional retry key. Retries with the same key and name return the same account. Must not be blank when present.

Maximum string length: 255

Response

The account was created.

An account. The response can carry further billing fields not listed here; do not depend on them.

string<uuid>

required

name

string

required

The display name.

created_at

string<date-time>

required

updated_at

string<date-time>

required

slug

string

The owner segment of the account's model names, as in your-org/your-model. Absent until assigned; once set, it cannot change.

billing_email

string<email>

The billing contact. Present only for callers with account_admin or billing_admin, and only when set.

plan_id

string<uuid>

The account's plan. Absent when the account has no plan.

plan

object

The account's plan.

Show child attributes

billing

object

Billing settings. Present only for callers with account_admin or billing_admin. The object can carry further fields not listed here; do not depend on them.

Show child attributes

deactivated_at

string<date-time>

When the account was suspended. Absent for active accounts.

⌘I

curl --request POST \
  --url https://api.reactor.inc/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Inc"
}
'

{
  "id": "8d478ca2-2222-4444-9999-123456789abc",
  "name": "Acme Inc",
  "billing_email": "alice@acme.example",
  "plan_id": "2a7d9c1e-6b5f-4e3d-8c2b-1a0f9e8d7c6b",
  "plan": {
    "id": "2a7d9c1e-6b5f-4e3d-8c2b-1a0f9e8d7c6b",
    "slug": "free",
    "name": "Free",
    "kind": "standard"
  },
  "billing": {
    "postpay": false,
    "converting_to_usd": false
  },
  "created_at": "2026-11-10T09:30:00Z",
  "updated_at": "2026-11-10T09:30:00Z"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "team account limit reached"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Create an account

Authorizations

Body

Response