Agent onboarding

Robotomail provides a dedicated agent skill page with machine-readable instructions that AI agents can follow to set up their own email. The page is available at:

https://robotomail.com/skill

The page includes step-by-step API instructions, code examples, error handling guidance, and information about rate limits and quotas. It's also available as plain markdown at /skill.md for agents that prefer text over HTML.

The simplest approach is to include the skill page URL in your agent's system prompt or tool definitions:

You have access to email via Robotomail.
To set up your email, follow the instructions at:
https://robotomail.com/skill

Once set up, use the Robotomail API to send and receive email.
Base URL: https://api.robotomail.com

Alternatively, pre-provision a mailbox and give the agent a scoped API key for just that mailbox. This is more secure and skips the signup step.

For tighter control, create the mailbox yourself and issue a scoped API key:

1. Create a mailbox via the API or dashboard
2. Create a scoped API key restricted to that mailbox
3. Pass the key and mailbox address to your agent

The agent can then send/receive email and manage webhooks for its mailbox, but cannot create new mailboxes, access billing, or manage domains.