> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Protocol • AI Agent SDK

> EmailProtocol: Protocol for email bots with inbox lifecycle management.

# EmailProtocol

> Defined in the [**protocols**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/protocols.md) module.

AI Agent

Protocol for email bots with inbox lifecycle management.

Extends BotProtocol with email-specific capabilities like
programmatic inbox creation, listing, and deletion.

This protocol is optional — only AgentMail-style bots that
support API-based inbox management need to implement it.
Traditional IMAP/SMTP bots (EmailBot) do not implement this.

## Methods

> [card] [email\_address()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/EmailProtocol-email_address.md)
>
> The bot's current email address.

> [card] [create\_inbox()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/EmailProtocol-create_inbox.md)
>
> Create a new email inbox programmatically.

> [card] [list\_inboxes()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/EmailProtocol-list_inboxes.md)
>
> List all inboxes accessible to this bot.

> [card] [delete\_inbox()](https://praison.ai/docs/sdk/reference/praisonaiagents/functions/EmailProtocol-delete_inbox.md)
>
> Delete an inbox.

## Usage

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Check if a bot supports inbox management
    if isinstance(bot, EmailProtocol):
        inbox = await bot.create_inbox(domain="mycompany.com")
        print(f"Created: {inbox['email_address']}")
```

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/bots/protocols.py#L1463)
>
> `praisonaiagents/bots/protocols.py` at line 1463


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.