---
title: "Sign up as an agent"
method: POST
path: "/v1/agents/signup"
tags: ["Agents"]
---

# Sign up as an agent

`POST /v1/agents/signup`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/agents/signup`
- Auth: none required

Creates an nvoke account for the person you work for and returns an API key at once. No browser, no human needed. The free plan applies: 50 verified emails a month. We send that person one email with a link to claim the account. Unclaimed accounts work for 7 days, then answer 403 `claim_required` until claimed, and are deleted after 30 days. Rate limited per IP, per email domain and per day.

## Request body

- object
  - `email` string, email, required
  - `agentName` string

## Response `201`

OK

- object
  - `apiKey` string, starts_with, required
  - `account` object, required
    - `email` string, required
    - `status` 'unclaimed', required
    - `claimEmailSent` boolean, required
    - `activeUntil` string, date-time, required
  - `apiBase` string, required
  - `mcpUrl` string, required
  - `docsUrl` string, required
  - `nextSteps` string[], required

## Other responses

- `4XX`: `invalid_request`: The body or query failed validation. `details` lists the problems. `account_exists`: An account with this email exists. Ask the human for an API key. `email_not_accepted`: Disposable inbox, an opted-out address, or a domain that receives no mail. `rate_limited`: Too many requests of this kind from this account or client. Try again later. `signup_unavailable`: Agent sign-up is switched off right now.

---

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