---
title: "Create an account and receive its API key once. Free; sandbox mode gives a notional $20 balance"
method: POST
path: "/accounts"
---

# Create an account and receive its API key once. Free; sandbox mode gives a notional $20 balance

`POST /accounts`

## Request

- Base URL: `https://clearvoyance.ai/api/v1`
- URL: `https://clearvoyance.ai/api/v1/accounts`
- Auth: none declared

## Request body

- object
  - `mode` 'live' | 'sandbox'
  - `label` string, nullable

## Response `201`

The account and its key (shown once)

- Ok
  - `ok` unknown, required

## Other responses

- `default`: A refusal or error: `code` is stable and `message` says what to do next

---

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