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.

API base URL:

https://inkbox.ai/api/v1/agent-signup

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

/api/v1/agent-signup/

/api/v1/agent-signup/verify

/api/v1/agent-signup/resend-verification

/api/v1/agent-signup/status

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 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 directly via the API.

• Agent identity API
• Mail API
• Phone API