MailgentGetting Started
Create an Identity
Set up your first agent email inbox
An Identity is your agent's email presence. It includes an email address, API key, and permission scopes.
Steps
-
Sign in to the Mailgent Console
-
Go to Identities in the sidebar
-
Click Create Identity
-
Fill in:
- Display Name — how your agent appears (e.g., "Sales Agent")
- Email Name — the local part of the email (e.g.,
salesagent). We append a random 5-character suffix for uniqueness, so you'll get something likesalesagent-x8k2m@mailgent.dev - Scopes — what the agent is allowed to do
-
Click Create
-
Copy the API key immediately — it's only shown once
Scopes
| Scope | Permission |
|---|---|
mail:read | List and read messages and threads |
mail:send | Send emails and reply to threads |
mail:manage | Update labels (mark read/unread, flag) |
What You Get
After creation, your identity has:
- Email address:
salesagent-x8k2m@mailgent.dev - API key:
mgent-a3f91b00...(used for authentication) - Scopes: The permissions you selected