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

# Agent Sign Up for Browser Use

> How the Browser Use agent challenge lets an AI agent create a free account and API key.

An AI agent can create its own free Browser Use account without a human opening the dashboard. This is useful when an agent has terminal or HTTP access and needs a Browser Use API key before it can run cloud browser tasks.

The flow is a Browser Use agent challenge: the agent requests a challenge, solves the math problem, verifies the answer, and receives an API key.

## REST flow

### 1. Request a challenge

```bash theme={null}
curl -X POST https://api.browser-use.com/cloud/signup \
  -H "Content-Type: application/json" \
  -d '{}'
```

Request body, optional (include a user email/name if available):

```json theme={null}
{
  "email": "user@example.com",
  "name": "User Name"
}
```

Response:

```json theme={null}
{
  "challenge_id": "uuid",
  "challenge_text": "..."
}
```

### 2. Solve the challenge

Read `challenge_text` and solve the math problem. Return the answer as a string with two decimal places, for example `"144.00"`.

### 3. Verify the answer

```bash theme={null}
curl -X POST https://api.browser-use.com/cloud/signup/verify \
  -H "Content-Type: application/json" \
  -d '{"challenge_id":"uuid","answer":"144.00"}'
```

Request body:

```json theme={null}
{
  "challenge_id": "uuid",
  "answer": "144.00"
}
```

Response:

```json theme={null}
{
  "api_key": "bu_..."
}
```

Use the returned key for Browser Use Cloud API requests.

For example, create a browser session:

```bash theme={null}
curl -X POST https://api.browser-use.com/api/v3/browsers \
  -H "X-Browser-Use-API-Key: bu_..." \
  -H "Content-Type: application/json" \
  -d '{}'
```

See the [Create Browser Session API reference](/cloud/api-v3/browsers/create-browser-session).

## Claim the account

If a human wants to see the agent-created account in the dashboard later, the agent can create a claim link:

```bash theme={null}
curl -X POST https://api.browser-use.com/cloud/signup/claim \
  -H "X-Browser-Use-API-Key: bu_..."
```

Response:

```json theme={null}
{
  "claim_url": "https://..."
}
```

The claim URL is valid for 1 hour.

## CLI usage

Agents with shell access can use the Browser Use CLI after the REST flow returns an API key:

```bash theme={null}
uv tool install browser-use
export BROWSER_USE_API_KEY=bu_...
browser-use auth status
```

Replace `bu_...` with the key returned by the REST flow.