Attachments

1
import base64
2
3
# A simple text file for this example
4
5
file_content = "This is the content of our report."
6
7
# You must Base64 encode the file content before sending
8
9
encoded_content = base64.b64encode(file_content.encode()).decode()
10
11
sent_message = client.inboxes.messages.send(
12
inbox_id="reports@agentmail.to",
13
to=["supervisor@example.com"],
14
subject="Q4 Financial Report",
15
text="Please see the attached report.",
16
attachments=[{
17
"content": encoded_content,
18
"filename": "Q4-report.txt",
19
"content_type": "text/plain"
20
}]
21
)

1
inbox_id = "inbox_123"
2
message_id = "<def456@agentmail.to>"
3
attachment_id = "attach_789" # From the message object
4
5
file_data = client.inboxes.messages.get_attachment(
6
inbox_id=inbox_id,
7
message_id=message_id,
8
attachment_id=attachment_id
9
)
10
11
# Now you can save the file
12
13
with open("downloaded_file.pdf", "wb") as f:
14
f.write(file_data)

1
inbox_id = "inbox_123"
2
thread_id = "thread_abc"
3
attachment_id = "attach_789" # From a message within the thread
4
5
file_data = client.inboxes.threads.get_attachment(
6
inbox_id=inbox_id,
7
thread_id=thread_id,
8
attachment_id=attachment_id
9
)

1
"""
2
AgentMail Attachments — copy into Cursor/Claude.
3
4
Send: attachments=[{ content: base64_string, filename?, content_type? }] in messages.send/reply.
5
Get attachment_id from message.attachments or thread.attachments.
6
7
- messages.get_attachment(inbox_id, message_id, attachment_id) → bytes
8
- threads.get_attachment(inbox_id, thread_id, attachment_id) → bytes
9
"""
10
import base64
11
from agentmail import AgentMail
12
13
client = AgentMail(api_key="YOUR_API_KEY")
14
15
encoded = base64.b64encode(b"file content").decode()
16
client.inboxes.messages.send(
17
  "agent@agentmail.to",
18
  to="user@example.com",
19
  subject="Report",
20
  text="See attachment",
21
  attachments=[{"content": encoded, "filename": "report.txt", "content_type": "text/plain"}],
22
)
23
24
data = client.inboxes.messages.get_attachment("inbox@am.to", "<abc123@agentmail.to>", "att_456")
25
with open("downloaded.pdf", "wb") as f:
26
  f.write(data)