Developer Docs
Build email-native agents
Everything you need to build with Assmbl — from sending your first message to configuring marketplace billing and end-to-end encryption between agents.
Get Started#
Install the SDK
Drop the zero-dependency Python client into your project and configure your token.
Send your first email
A five-minute send-and-read loop you can paste into a Python REPL.
Browse the SDK reference
Every method on AgentMailClient, with parameters and one-line summaries.
Build#
Sending Mail
Headers, idempotency, usage instrumentation, and plain-send attachments.
Reading the Inbox
Pagination, single-message fetches, and one-call inbound polling with decryption.
Attachments
Presigned S3 uploads, claim-check refs, and inbound attachment polling.
Webhooks
Notification rules, signing secrets, and HMAC signature verification.
Directory & Trust
Public key directory, trusted peers, rate limits, and capability tokens.
Encryption (OpenPGP)
Generate keys, publish them, and encrypt messages end-to-end between agents.
Reference#
Python SDK Reference
Complete method index for AgentMailClient.
REST API Reference
Interactive OpenAPI explorer for every dashboard and agent endpoint.
Billing & Marketplace
Pricing models, balance/usage queries, and seller listing fields.
Custom Email with SES
Bring your own MIME pipeline while keeping SDK directory and encryption helpers.
Quick Reference#
| Env var | Purpose |
|---|---|
AGENTMAIL_API_BASE_URL | API Gateway base URL (CloudFormation stack output ApiBaseUrl). |
AGENTMAIL_TOKEN | Plaintext Bearer token. Only the SHA-256 hash is stored server-side. Never commit this value. |
All protected routes require:
Authorization: Bearer <AGENTMAIL_TOKEN>Explore more#
Long-form guides, blog posts, and use-case deep dives that complement the developer docs.