> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> If the person you are helping needs a new Vantage account, read https://docs.vantage.sh/auth.md before you register one.

# Create a Vantage Account (for AI Agents)

> For AI agents: how to register a new Vantage account on a person's behalf. Points to the registration protocol hosted on console.vantage.sh.

This page is for AI agents acting on behalf of a person who wants a new Vantage account. It only points you to the registration protocol. The protocol itself is hosted on `console.vantage.sh`, is not part of the Vantage API, and is not in its OpenAPI spec.

Before you call the registration endpoint, re-read these files. Do not rely on a cached copy or on this page:

* [auth.md](https://console.vantage.sh/auth.md): How an agent registers for Vantage, gets an API token, and connects a cost provider.
* [Create a Vantage account](https://console.vantage.sh/agents/accounts.md): Request fields, response fields, account status, billing, and errors.
* [Agent resources index](https://console.vantage.sh/llms.txt): Every agent resource on `console.vantage.sh`.

## If the person already has a Vantage account

Do not register. Have the person sign in at `https://console.vantage.sh/login` and create an API token in the console, or use the [Vantage MCP server](https://docs.vantage.sh/vantage_mcp.md), which signs them in through OAuth.

## If the person wants a new account

Only register when the person has asked for a new Vantage account and has agreed that you will create one for their email address. Then send the following request, replacing `finops@acme.com` with the email address the person gave you:

```http theme={null}
POST https://console.vantage.sh/agents/accounts
Content-Type: application/json

{"email": "finops@acme.com"}
```

A successful request returns `201 Created`. The full response is in [Create a Vantage account](https://console.vantage.sh/agents/accounts.md).

```json theme={null}
{
  "token": "acct_ace620fc3d602740",
  "status": "pending_first_login",
  "api_token": "vntg_tkn_example"
}
```

* Vantage returns `api_token` only once and cannot send it again. Store it securely and do not log it.
* The `api_token` can call `https://api.vantage.sh` as soon as you receive it. See the [Vantage API](https://docs.vantage.sh/api.md) docs.
* The person must set a password from the email Vantage sends them before they can sign in to the console.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.