> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-docs-whatsapp-interface-documentation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS SES

**AWSSESTool** enables an Agent to send emails using Amazon Simple Email Service (SES).

## Prerequisites

The following example requires the `boto3` library and valid AWS credentials. You can install `boto3` via pip:

```shell theme={null}
uv pip install boto3
```

You must also configure your AWS credentials so that the SDK can authenticate to SES. The easiest way is via the AWS CLI:

```shell theme={null}
aws configure
# OR set environment variables manually
export AWS_ACCESS_KEY_ID=****
export AWS_SECRET_ACCESS_KEY=****
export AWS_DEFAULT_REGION=us-east-1
```

<Note>
  Make sure to add the domain or email address you want to send FROM (and, if
  still in sandbox mode, the TO address) to the verified emails in the [SES
  Console](https://console.aws.amazon.com/ses/home).
</Note>

## Example

The following agent researches the latest AI news and then emails a summary via AWS SES:

```python aws_ses_tools.py theme={null}
from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.aws_ses import AWSSESTool
from agno.tools.hackernews import HackerNewsTools

# Configure email settings
sender_email = "verified-sender@example.com"  # Your verified SES email
sender_name = "Sender Name"
region_name = "us-east-1"

agent = Agent(
    name="Research Newsletter Agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[
        AWSSESTool(
            sender_email=sender_email,
            sender_name=sender_name,
            region_name=region_name
        ),
        HackerNewsTools(),
    ],
    markdown=True,
        instructions=[
        "When given a prompt:",
        "1. Extract the recipient's complete email address (e.g. user@domain.com)",
        "2. Research the latest AI developments using HackerNews",
        "3. Compose a concise, engaging email summarising 3 – 4 key developments",
        "4. Send the email using AWS SES via the send_email tool",
    ],
)

agent.print_response(
    "Research recent AI developments in healthcare and email the summary to johndoe@example.com"
)
```

## Toolkit Params

| Parameter           | Type   | Default       | Description                              |
| ------------------- | ------ | ------------- | ---------------------------------------- |
| `sender_email`      | `str`  | `None`        | Verified SES sender address.             |
| `sender_name`       | `str`  | `None`        | Display name that appears to recipients. |
| `region_name`       | `str`  | `"us-east-1"` | AWS region where SES is provisioned.     |
| `enable_send_email` | `bool` | `True`        | Enable the send\_email functionality.    |
| `all`               | `bool` | `False`       | Enable all functionality.                |

## Toolkit Functions

| Function     | Description                                                                          |
| ------------ | ------------------------------------------------------------------------------------ |
| `send_email` | Send a plain-text email. Accepts the arguments: `subject`, `body`, `receiver_email`. |

## Developer Resources

* View [Tools](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/aws_ses.py)
* [Amazon SES Documentation](https://docs.aws.amazon.com/ses/latest/dg/)