---
id: account-create
title: "Create an account"
description: "Creates a new account."
sidebar_label: "Create an account"
hide_title: true
hide_table_of_contents: true
api: eJzdWG1v2zYQ/isEP22A7NhO0gEehsHNui3dS4PGxYolRnKWzhYbiVTJUxzX0H8fjpIsKXZTb+g2bPkgK9LxXp5710ZG6EKrMlJGy7E8swiEToDQuBIQhibX1JeBJFg6Ob6Sk/KRnAXSZGiBz51Hciwr2nHoOchAWnyfo6PnJlrL8UaGRhNq4lvIskSF/ujRO8dyN9KFMabAd7TOUI6lmb/DkCo+ymLE0jWkzNol+ZJ/CCh3MpDGLkGrD57jjYpYucyyeqTQMU9/ruHtyCrNHLrGT2MUTCnMQlCMbfPxAdIsQY/QOiMjfjJ6KYtKlYM4M+WTnEPPuXdXcX5sVCNEacIl2r1Szr+rZbTPC4qBhFlpJyhWbq/84ei42GK6xyLUeco+gJDUPXtB6ep2ttdcz+hJg6vjRRFIUlQ98nRlGMqi4HcOw9wqWsvx1UbOESzaSU6xHF/NihnHh8uMdqWjR4Mh/+yqUzEWK3CiDNGIlfksUakiGTwKzcfO2wK7E5oHeXYi3NoRpr2VilDkWr3PvasXxn4U3uHo+KQIPhr6KTz8jHrJOD4b7HNgjRgz+Esp0JLw1Y6Eie4EaMcwnylPmfbfTRXWI0HC6M8kjeBXt9XBW3EPSY5COWF0shYWKbcaI6H0td7mgiAjbn94MRVHFZOjjYqKb11sVjcVo2/I5njrca5o3LX2xsdwj2KOqIUzC+pV9F8LRSIErQ2JOQqHJO4VVMkkjBV5FgFh/1rvTfKt5TdA+zBbGJvyG8lMeqR8Nuk8SWDOfFjZfYgxoSNIMwEkVrEK4zZ0Pt3bRgSs6C2zvRVqwfY2tMoJRypJRKlyX7xifDOT5QmXC6G0aON7rQ8C+DEeo8HoWW9w2hueToej8fHJ+PRZfzAY/M4IpUgQAe0tOLum19QiMRBh5L1B7echECRmKSYX553w3cg7XMux9IHEcrsVyb88pKPd4boO1VpmN02ZUxFUcg5iWcb2U0zZd0UgIYoUn4Pkpqv907hNtscamJrzgVA6TPJI6aUoS78ToCPBww8r0ZVUUbSEgrWw3mvXy8tXv25Z7jFPEaZ71Pet0U9en5IBSyfAORMqH6srRfGhQg70/+FubSirCCv/mi7/S6XUmUkzo7n/7pkBqu5/8vbtbkc/SxRqEmitsa2kjHLkwqf0PSSKEzbLiRM+Vc6xTzOwkCKhdZ+t95cV+8xEXK68Ptz50DlY4m6zb1F/ukf9OJ1e1B0hNBEKi5lFh5rYFnauyzBUCxWKsI3HF9hf9gNxMhjwZciXY76cfNlJpJPBoGAQogNScyJSCGOlsWcRIq7IlSyvl28aIRAujVUfuDiybmjv0YoFqCS3jwaIOUQ31XrAgVTCdoASc6twEYg4T0E3mrSo6tQqlWN2NRrX8jlE4nUp9Frygzcacoq9ytG17ILTpi4rc+nRTyvZFJgICVTiBMxNTo1aXTlcHCoofLNKIeFOiJHw6GoCVTb3MqTbEVxn1em+DDnXhJa1qPxQIlIlCGiRa3zIMPR9zbkc/2cJ0bG6CoFTTojTwYgvx113n/57uaAqR92URDclZP9YVmzj5LLU8QXTlPnBT1SI4o2Ge1B+DttJk73H/9aEmXRitzTJhGFuLUZ9cZEgOBRk1wKWoLTg0c32mxaUIsWGv1dkxvnWB7yfyHqK40XNW+L8tpnbRI5lTJS58dERZKrP40eWAHGS9kOTSl5B6w31kjOkDOz2nrqFgBmxBE/GddATyaC6+b4egV/+NvUdkTPvdfMZ5UUzwJVbXWcTqxexznK0Zzcajo6b3aU1niu9MMyajS9dM+wP+gPZNOb62w9PjMZRCrqjit8DQIsGyo6nW5+AnvjMVAJF+EBHWQJKszDvhU3lqqvtfDALZMxOHF/JzWYODt/YpCj48fscLX8umPGQYlW5QVzNikDGCBFa79tyBj4rdepNWfB2ptmtf0VQn5iEIWb0JO2sFWcXry6n7OHqM1jqa4y0sOK6CSs5luwkj5EPHP9sIxPQy9wnkCx5cjxAN5wehY+3qp4S9bql4WZTUkzNHeqikEFlCvH/spgVRfEH00XvsQ==
sidebar_class_name: "post api-method"
info_path: docs/api/account
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create an account"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/account"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Creates a new account.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","required":["name","slug","status","organization_id"],"properties":{"name":{"type":"string","description":"The name of the account.","example":"Crypto Kong"},"slug":{"type":"string","description":"The slug of the account.","example":"crypto-kong"},"organization_id":{"type":"integer","description":"The ID of the organization that owns this account.","example":123},"status":{"type":"string","enum":["active","inactive"],"description":"The status of the account.","example":"active"}},"title":"accountCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"201":{"description":"The account was created.","content":{"application/json":{"schema":{"type":"object","required":["id","name","slug","organization_id","status"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the account.","example":1234},"name":{"type":"string","maxLength":60,"description":"The account name.","example":"Crypto Kong"},"slug":{"type":"string","maxLength":70,"description":"An organization-wide unique slug for the account.","example":"crypto-kong"},"organization_id":{"type":"integer","description":"The ID of the organization that owns this account.","example":123},"status":{"type":"string","enum":["active","inactive","deleted"],"description":"The status of the account. The `deleted` value is only returned in\nresponses to `GET /account/{id}?show_deleted=true` for accounts\nthat have been soft-deleted; it cannot be set via create or update.\n","example":"active"},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"The timestamp at which the account was soft-deleted, or `null` if\nthe account is still active. Only populated in responses to\n`GET /account/{id}?show_deleted=true`.\n","example":"2026-05-15T12:34:56.000Z"},"metadata":{"type":"object","description":"The metadata loaded via the metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata.","example":"key"},"value":{"type":"string","description":"The value of the metadata.","example":null},"additional_properties":{"type":"object","description":"Additional metadata properties, including schemas and tags.","properties":{"schemas":{"type":"array","description":"The JSON schemas of the metadata.","items":{"type":"object"}},"tags":{"type":"array","description":"Tags associated with the metadata.","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}}}}},"title":"MetadataComponent"}},"title":"account"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Internal server error due to an unexpected issue.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>