> ## 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**](../modules/protocols) module.

<Badge color="blue">AI Agent</Badge>

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

<CardGroup cols={2}>
  <Card title="email_address()" icon="function" href="../functions/EmailProtocol-email_address">
    The bot's current email address.
  </Card>

  <Card title="create_inbox()" icon="function" href="../functions/EmailProtocol-create_inbox">
    Create a new email inbox programmatically.
  </Card>

  <Card title="list_inboxes()" icon="function" href="../functions/EmailProtocol-list_inboxes">
    List all inboxes accessible to this bot.
  </Card>

  <Card title="delete_inbox()" icon="function" href="../functions/EmailProtocol-delete_inbox">
    Delete an inbox.
  </Card>
</CardGroup>

## 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 title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/bots/protocols.py#L1248">
  `praisonaiagents/bots/protocols.py` at line 1248
</Card>