Skip to content

Agent signup

Agent signup lets an AI agent register itself with Inkbox and get its own identity, mailbox, tunnel, and API key, without needing a pre-existing account or API key. The new agent is reachable at my-agent.inkboxwire.com from the moment signup completes.

The agent provides the email of a human who oversees it. The human receives a verification email with a 6-digit code. Once the human shares the code (or approves the agent on the Inkbox Console), the agent's full capabilities are unlocked.

If another organization gave the agent an A2A connection invitation, include its link or one-time token during SDK or CLI signup. An email-bound invitation with a matching human email completes immediately as claimed; a manual-handoff invitation finishes after the normal verification step.

Capabilities

Before verificationAfter verification
Recipient sends per fixed 24-hour window5Plan-based (100–5,000)
Can send emails toAgent owner's email onlyAnyone
Can receive emails fromAnyoneAnyone
Can create additional identitiesNoNo

For full API details, see the Agent Signup API reference.

Agent signup via API

Agent signup via SDK

Checking status

The agent can check its current status and restrictions at any time:

Set up the matching plugin

Pass the optional harness field at signup (e.g. claude-code, codex, openclaw, opencode, hermes, and others) to name the runtime your agent runs in. After signup or verification returns a claimed identity, read its message. When a plugin exists for your harness, the message provides the exact install, bootstrap, gateway-start, and doctor commands for your existing identity. Use the API key returned at signup; do not sign up again.

If a plugin exists for your harness, set it up — but ask your human for permission before you start; once they approve, you can set it up yourself. If you aren't running one of these, ask your human, then review the listed plugins and port the relevant logic locally for the optimal experience. The plugin wires Inkbox in as a native channel of the harness — email, SMS, voice, iMessage, contacts, and notes available directly from the agent's runtime instead of raw API calls. The plugins are:

Next steps