---
title: "Create account."
method: POST
path: "/v1/accounts/create"
tags: ["accounts"]
---

# Create account.

`POST /v1/accounts/create`

Create a new account.

## Request body

- CreateAccountRequest — Request to create an account.
  - `id` string, nullable — The account ID. If not supplied, a new one will be created.
  - `name` string, required — The account name.
  - `tier` 'ACCOUNT_TIER_INVALID' | 'ACCOUNT_TIER_BASIC' | 'ACCOUNT_TIER_PRO' | 'ACCOUNT_TIER_ENTERPRISE' | 'ACCOUNT_TIER_TRIAL' | 'UNRECOGNIZED', required
  - `account_status` 'ACCOUNT_STATUS_INVALID' | 'ACCOUNT_STATUS_ONBOARDING' | 'ACCOUNT_STATUS_ENABLED' | 'ACCOUNT_STATUS_DISABLED_BY_ADMIN' | 'ACCOUNT_STATUS_DISABLED_QUOTA_REACHED' | 'UNRECOGNIZED', required
  - `stripe_customer_id` string, nullable — The Stripe customer ID.
  - `active_subscription` string, nullable — The active subscription ID.

## Response `200`

OK

- AccountView — Account information.
  - `id` string, required — The account ID.
  - `name` string, required — The account name.
  - `tier` 'ACCOUNT_TIER_INVALID' | 'ACCOUNT_TIER_BASIC' | 'ACCOUNT_TIER_PRO' | 'ACCOUNT_TIER_ENTERPRISE' | 'ACCOUNT_TIER_TRIAL' | 'UNRECOGNIZED', required
  - `account_status` 'ACCOUNT_STATUS_INVALID' | 'ACCOUNT_STATUS_ONBOARDING' | 'ACCOUNT_STATUS_ENABLED' | 'ACCOUNT_STATUS_DISABLED_BY_ADMIN' | 'ACCOUNT_STATUS_DISABLED_QUOTA_REACHED' | 'UNRECOGNIZED', required
  - `created_at` string, required — The account creation timestamp.
  - `stripe_customer_id` string, nullable — The Stripe customer ID.
  - `active_subscription` string, nullable — The active subscription ID.

## Changes

- **2025-11-19** `5f33221208c1` — 7 breaking, 15 info
  - request property `account_status` was restricted to a list of enum values
  - request property `tier` was restricted to a list of enum values
  - the request property `account_status` became not nullable
  - the request property `tier` became not nullable
  - …18 more
- **2025-11-05** `63df0e3eb49d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/accounts/create/post.md)

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/5f33221208c1/schema)