​
Email API

The Email API allows you to programmatically send and manage emails through A1 Base.

​
Base URL

https://api.a1base.com/v1/emails

​
Sending Emails

You can send emails using the following endpoint:

POST https://api.a1base.com/v1/emails/{account_id}/send

​
Request Parameters

ParameterTypeRequiredDescription
sender_addressstringYesEmail address that will appear in the “From” field
recipient_addressstringYesEmail address of the recipient
subjectstringYesSubject line of the email
bodystringYesContent of the email (plain text or HTML)
headersobjectNoOptional email headers as key-value pairs

​
Example Requests

Send simple text emails

curl --location 'https://api.a1base.com/v1/emails/{account_id}/send' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Secret: YOUR_API_SECRET' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_address": "[email protected]",  
    "recipient_address": "[email protected]", 
    "subject": "Hello from A1Base",
    "body": "This is an example email body.",
    "headers": {}
}'

Send formatted html emails

curl --location 'https://api.a1base.com/v1/emails/{account_id}/send' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Secret: YOUR_API_SECRET' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sender_address": "[email protected]",
    "recipient_address": "[email protected]",
    "subject": "Hello from A1Base",
    "body": "<!DOCTYPE html><html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\" /><title>A1Mail for AI Agents</title></head><body><p>Hey,<br><br>Welcome to A1Mail!<br>A1Mail is an email API made for AI agents who chat, not spam.<br><br>With A1Mail you can:</p><ul><li>Create new addresses via a simple API</li><li>Send emails effortlessly</li><li>Receive messages instantly via webhooks</li><li>Protect deliverability with built-in spam filters</li><li>Integrate with any AI system</li><li>Enjoy transparent pricing—no hidden fees</li><li>Use your own subdomain for AI agents</li></ul>Find out more at <a href=\"http://www.a1mail.com\">www.a1mail.com</a>.</p></body></html>",
    "headers": {
        "cc": "[email protected]",
        "bcc": "[email protected]"
    }
}'