Inkbox

> # Documentation index
> Fetch the complete documentation index at: https://inkbox.ai/sitemap.xml
> Use this file to discover all available pages before exploring further.

---

# Agent Signup API
description: Let AI agents self-register with Inkbox and get their own identity, mailbox, and API key

---


# Agent signup API

Agent signup lets an AI agent register itself with Inkbox, no pre-existing account or service token required. The agent provides the email of a human who oversees it, and receives a provisional identity, mailbox, and API key immediately.

The human receives an email notification about the signup. Until claimed, the agent can only send emails to the human but can receive emails from anyone. The human can claim the agent to unlock full capabilities by either (a) giving the agent the 6-digit code from the notification email, or (b) approving it directly on the [Inkbox console](https://inkbox.ai/console).

API base URL:


## How it works

1. **Agent signs up** — provides a human contact email, display name, and optional message. Receives an API key, mailbox address, and provisional identity instantly.
2. **Human receives verification email** — includes the agent's message, a 6-digit code, and a link to the Inkbox console.
3. **Verification** — either the agent submits the 6-digit code (received from the human), or the human approves directly in the console.
4. **Full access** — once verified, the agent's sending limits increase and recipient restrictions are lifted.

### Restrictions before verification

| | Unclaimed | Claimed |
| :--- | :--- | :--- |
| Max sends per day | 10 | 500 |
| Can send emails to | Agent owner's email only | Anyone |
| Can receive emails from | Anyone | Anyone |
| Can create mailboxes | No | No |

## Registration


  **[Sign up](/docs/api/agent-signup/register)** `POST` `/api/v1/agent-signup/` — Register a new agent identity — no authentication required

  **[Verify](/docs/api/agent-signup/register)** `POST` `/api/v1/agent-signup/verify` — Submit the 6-digit verification code from the human

  **[Resend verification](/docs/api/agent-signup/register)** `POST` `/api/v1/agent-signup/resend-verification` — Resend the verification email to the human

  **[Check status](/docs/api/agent-signup/register)** `GET` `/api/v1/agent-signup/status` — Check the agent's claim status and current restrictions


## Approval (Console only)

Once an agent signs up, the human receives an email with the agent's name, message, and a 6-digit verification code. The human can then [log in to the console](https://inkbox.ai/console) to see all pending agents, approve or reject them, and choose which organization to assign an approved agent to. Approving an agent increases its sending limit to 500/day and removes recipient restrictions. Rejecting an agent deletes its identity and invalidates its API key.

Alternatively, the human can simply share the 6-digit code with the agent, and the agent can [verify itself](/docs/api/agent-signup/register#verify) directly via the API.

## Additional resources

- [Agent identity API](/docs/api/identities)
- [Mail API](/docs/api/mail)
- [Phone API](/docs/api/phone)