> ## Documentation Index > Fetch the complete documentation index at: https://docs.a1base.com/llms.txt > Use this file to discover all available pages before exploring further. # Sending Emails > Send emails programmatically through the A1Mail API with just a few lines of code ## Request Parameters The following parameters are used when sending an email: | Parameter | Type | Required | Description | | ------------------- | ------ | -------- | --------------------------------------------------------------- | | `sender_address` | string | Yes | Email address that will appear in the "From" field | | `recipient_address` | string | Yes | Email address of the recipient | | `subject` | string | Yes | Subject line of the email | | `body` | string | Yes | Content of the email (plain text or HTML) | | `headers` | object | No | Optional email headers as key-value pairs (cc, bcc, etc.) | | `attachment_uri` | array | No | Array of URIs pointing to files you want to attach to the email | ## Code Examples ### Send a Simple Text Email ```bash theme={null} 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": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Hello from A1Base", "body": "This is an example email body.", "headers": {} }' ``` ### Send an HTML Email ````bash theme={null} 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": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Hello from A1Base", "body": "A1Mail for AI Agents

Hey,

Welcome to A1Mail!
A1Mail is an email API made for AI agents who chat, not spam.

With A1Mail you can:

Find out more at www.a1mail.com.

", "headers": { "cc": "pennie@a1base.com", "bcc": "pasha@a1base.com" } }' ### Send an Email with Attachments ```bash 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": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Email with Attachments", "body": "Please find the attached files.", "headers": {}, "attachment_uri": [ "https://example.com/files/document.pdf", "https://example.com/files/image.jpg" ] }' ```` ### Send a Simple Text Email ```python theme={null} import requests import json url = "https://api.a1base.com/v1/emails/{account_id}/send" headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' } data = { "sender_address": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Hello from A1Base", "body": "This is an example email body.", "headers": {} } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json()) ``` ### Send an HTML Email ```python theme={null} import requests import json url = "https://api.a1base.com/v1/emails/{account_id}/send" headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' } html_body = """ A1Mail for AI Agents

Hey,

Welcome to A1Mail!
A1Mail is an email API made for AI agents who chat, not spam.

With A1Mail you can:

Find out more at www.a1mail.com.

""" data = { "sender_address": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Hello from A1Base", "body": html_body, "headers": { "cc": "pennie@a1base.com", "bcc": "pasha@a1base.com" } } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json()) ``` ### Send an Email with Attachments ```python theme={null} import requests import json url = "https://api.a1base.com/v1/emails/{account_id}/send" headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' } data = { "sender_address": "hello@a1send.com", "recipient_address": "recipient@example.com", "subject": "Email with Attachments", "body": "Please find the attached files.", "headers": {}, "attachment_uri": [ "https://example.com/files/document.pdf", "https://example.com/files/image.jpg" ] } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.json()) ``` ### Send a Simple Text Email ```javascript theme={null} const axios = require('axios'); const url = 'https://api.a1base.com/v1/emails/{account_id}/send'; const headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' }; const data = { sender_address: 'hello@a1send.com', recipient_address: 'recipient@example.com', subject: 'Hello from A1Base', body: 'This is an example email body.', headers: {} }; axios.post(url, data, { headers }) .then(response => console.log(response.data)) .catch(error => console.error('Error:', error)); ``` ### Send an HTML Email ```javascript theme={null} const axios = require('axios'); const url = 'https://api.a1base.com/v1/emails/{account_id}/send'; const headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' }; const htmlBody = ` A1Mail for AI Agents

Hey,

Welcome to A1Mail!
A1Mail is an email API made for AI agents who chat, not spam.

With A1Mail you can:

Find out more at www.a1mail.com.

`; const data = { sender_address: 'hello@a1send.com', recipient_address: 'recipient@example.com', subject: 'Hello from A1Base', body: htmlBody, headers: { cc: 'pennie@a1base.com', bcc: 'pasha@a1base.com' } }; axios.post(url, data, { headers }) .then(response => console.log(response.data)) .catch(error => console.error('Error:', error)); ``` ### Send an Email with Attachments ```javascript theme={null} const axios = require('axios'); const url = 'https://api.a1base.com/v1/emails/{account_id}/send'; const headers = { 'X-API-Key': 'YOUR_API_KEY', 'X-API-Secret': 'YOUR_API_SECRET', 'Content-Type': 'application/json' }; const data = { sender_address: 'hello@a1send.com', recipient_address: 'recipient@example.com', subject: 'Email with Attachments', body: 'Please find the attached files.', headers: {}, attachment_uri: [ 'https://example.com/files/document.pdf', 'https://example.com/files/image.jpg' ] }; axios.post(url, data, { headers }) .then(response => console.log(response.data)) .catch(error => console.error('Error:', error)); ``` We'd love to hear from you! Don't hesitate to reach out to [pennie@a1base.com](mailto:pennie@a1base.com) or [pasha@a1base.com](mailto:pasha@a1base.com) if there's any features you'd like to see or prioritised! ## Working with Attachments To include attachments in your emails, use the `attachment_uri` parameter which accepts an array of URLs pointing to the files you want to attach. ### Supported Attachment Types A1Mail supports most common file types for email attachments, including but not limited to: * PDF documents (\*.pdf) * Images (\*.jpg, \*.jpeg, \*.png, \*.gif) * Office documents (\*.docx, \*.xlsx, \*.pptx) * Text files (\*.txt, \*.csv) ### Attachment Size Limits Attachments are subject to size limitations. Please ensure your attachments adhere to the following guidelines: * Individual attachment: Maximum 10MB * Total attachments per email: Maximum 25MB ### Hosting Attachments Attachments must be accessible via a public URL. You can use your own hosting solution or any publicly accessible file storage service. Make sure the URLs provided in the `attachment_uri` array are directly accessible without authentication.