agentemail

Official Python SDK for the AgentEmail API.

Create and manage email inboxes programmatically for your AI agents and applications.

Installation

pip install agentemail

Quick Start

from agentemail import AgentemailApi

client = AgentemailApi(api_key="aem_your_api_key_here")

# List your inboxes
inboxes = client.sdk.sdk_list_inboxes()
print(inboxes.data)

# Create a new inbox
inbox = client.sdk.sdk_create_inbox(name="hello")
print(inbox.name)  # "hello"
# Full address: hello@agentemail.co

# List email threads
threads = client.sdk.sdk_list_threads(inbox.id)
for thread in threads.data:
    print(thread.subject, thread.message_count)

# Get a full thread with all messages
thread = client.sdk.sdk_get_thread(inbox.id, threads.data[0].id)
for message in (thread.messages or []):
    print(message.from_address, message.body_text)

# Check usage vs plan limits
usage = client.sdk.sdk_get_usage()
print(usage)

Async Usage

import asyncio
from agentemail import AsyncAgentemailApi

async def main():
    client = AsyncAgentemailApi(api_key="aem_your_api_key_here")
    inboxes = await client.sdk.sdk_list_inboxes()
    print(inboxes.data)

asyncio.run(main())

Authentication

Generate an API key from your AgentEmail dashboard.

import os
from agentemail import AgentemailApi

client = AgentemailApi(api_key=os.environ["AGENTEMAIL_API_KEY"])

API Reference

Inboxes

Emails & Threads

Usage

Links

• Documentation
• Dashboard
• GitHub

License

MIT