# Agent onboarding

Point your AI agent at the Robotomail skill page for self-service email setup.

## The skill page

Robotomail provides a dedicated [agent skill page](https://robotomail.com/skill) with machine-readable instructions that AI agents can follow to set up their own email. The page is available at:

```url
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.


## Giving your agent email access

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

```system prompt
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.


## Pre-provisioned access

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.


---

Previous: [Custom domain setup](https://robotomail.com/docs/guides/custom-domain.md) | Next: [Claude Code channel](https://robotomail.com/docs/guides/claude-code-channel.md)