Drafts

1
# You'll need an inbox ID to create a draft in.
2
3
new_draft=client.inboxes.drafts.create(
4
    inbox_id="outbound@domain.com",
5
    to=["review-team@example.com"],
6
    subject="[NEEDS REVIEW] Agent's proposed response"
7
)
8
9
print(f"Draft created successfully with ID: {new_draft.draft_id}")

1
# Get the draft
2
draft = client.inboxes.drafts.get(inbox_id = “my_inbox@domain.com”, draft_id = “draft_id_123”)

1
# This sends the draft and deletes it
2
3
sent_message = client.inboxes.drafts.send(inbox_id = 'my_inbox@domain.com', draft_id = 'draft_id_123')
4
5
print(f"Draft sent! New message ID: {sent_message.message_id}")

1
# create a draft reply to the sender of a received message
2
draft = client.inboxes.drafts.create(
3
    inbox_id="agent@domain.com",
4
    in_reply_to="<message-id@domain.com>",
5
    text="Thanks — looping in my manager for approval.",
6
)
7
8
# reply to everyone on the thread
9
reply_all = client.inboxes.drafts.create(
10
    inbox_id="agent@domain.com",
11
    in_reply_to="<message-id@domain.com>",
12
    reply_all=True,
13
    text="Thanks all — I'll follow up with the details.",
14
)
15
16
# forward a message as a draft for later review
17
forward = client.inboxes.drafts.create(
18
    inbox_id="agent@domain.com",
19
    forward_of="<message-id@domain.com>",
20
    to=["teammate@example.com"],
21
    text="See below — can you take this one?",
22
)
23
24
# review, then send when ready
25
client.inboxes.drafts.send(inbox_id="agent@domain.com", draft_id=draft.draft_id)

1
# edit the body and recipients, add a label, and clear the cc list
2
client.inboxes.drafts.update(
3
    inbox_id="agent@domain.com",
4
    draft_id="draft_id_123",
5
    text="Updated body copy.",
6
    cc=None,  # clear the cc field
7
    add_labels=["reviewed"],
8
)

1
from datetime import datetime, timedelta
2
3
# Schedule an email for tomorrow at 9:00 AM UTC
4
send_time = (datetime.utcnow() + timedelta(days=1)).replace(
5
    hour=9, minute=0, second=0
6
)
7
8
scheduled_draft = client.inboxes.drafts.create(
9
    inbox_id="outreach@domain.com",
10
    to=["prospect@example.com"],
11
    subject="Following up on our conversation",
12
    text="Hi, just wanted to follow up on our chat yesterday...",
13
    send_at=send_time.isoformat() + "Z"
14
)
15
16
print(f"Draft scheduled for {scheduled_draft.send_at}")
17
# send_status will be "scheduled"

1
# Reschedule to a different time
2
new_time = (datetime.utcnow() + timedelta(days=3)).replace(hour=14, minute=0, second=0)
3
client.inboxes.drafts.update(
4
    inbox_id="outreach@domain.com",
5
    draft_id=scheduled_draft.draft_id,
6
    send_at=new_time.isoformat() + "Z"
7
)
8
9
# Or un-schedule but keep the draft (clears send_at and the 'scheduled' label)
10
client.inboxes.drafts.update(
11
    inbox_id="outreach@domain.com",
12
    draft_id=scheduled_draft.draft_id,
13
    send_at=None
14
)
15
16
# Or cancel by deleting the draft entirely
17
client.inboxes.drafts.delete(
18
    inbox_id="outreach@domain.com",
19
    draft_id=scheduled_draft.draft_id
20
)

1
# List all scheduled drafts in an inbox
2
scheduled = client.inboxes.drafts.list(
3
    inbox_id="outreach@domain.com",
4
    labels=["scheduled"]
5
)
6
7
for draft in scheduled.drafts:
8
    print(f"{draft.subject} — scheduled for {draft.send_at} ({draft.send_status})")

1
from datetime import datetime, timedelta
2
3
inbox_id = "outreach@domain.com"
4
5
# Send initial email
6
initial = client.inboxes.messages.send(
7
    inbox_id=inbox_id,
8
    to=["prospect@example.com"],
9
    subject="Quick question about your workflow",
10
    text="Hi, I noticed your team is scaling quickly..."
11
)
12
13
# Schedule follow-up for 3 days later
14
follow_up_time = (datetime.utcnow() + timedelta(days=3)).replace(hour=9, minute=0, second=0)
15
16
follow_up = client.inboxes.drafts.create(
17
    inbox_id=inbox_id,
18
    to=["prospect@example.com"],
19
    subject="Re: Quick question about your workflow",
20
    text="Hi again — just bumping this in case it got buried...",
21
    in_reply_to=initial.message_id,
22
    send_at=follow_up_time.isoformat() + "Z"
23
)
24
25
# Tag the thread so your webhook handler can find the draft
26
client.inboxes.threads.update(
27
    inbox_id=inbox_id,
28
    thread_id=initial.thread_id,
29
    add_labels=[f"follow-up:{follow_up.draft_id}"]
30
)

1
# In your webhook handler for "message.received":
2
thread = client.inboxes.threads.get(inbox_id=inbox_id, thread_id=thread_id)
3
4
for label in thread.labels:
5
    if label.startswith("follow-up:"):
6
        draft_id = label.split("follow-up:")[1]
7
        try:
8
            client.inboxes.drafts.delete(inbox_id=inbox_id, draft_id=draft_id)
9
        except Exception:
10
            pass  # Draft may have already been sent
11
        client.inboxes.threads.update(
12
            inbox_id=inbox_id, thread_id=thread_id,
13
            remove_labels=[label]
14
        )
15
        break

1
# Get all drafts across the entire organization
2
all_drafts = client.drafts.list()
3
4
print(f"Found {all_drafts.count} drafts pending review.")

1
"""
2
AgentMail Drafts — copy into Cursor/Claude.
3
4
Setup: pip install agentmail python-dotenv. Set AGENTMAIL_API_KEY in .env.
5
6
API reference:
7
- inboxes.drafts.create(inbox_id, to?, subject?, text?, html?, cc?, bcc?, reply_to?, attachments?, in_reply_to?, forward_of?, reply_all?, send_at?)
8
    * in_reply_to=<message_id> -> reply draft (add reply_all=True for the whole thread)
9
    * forward_of=<message_id> -> forward draft (body + attachments merged at send time)
10
    * in_reply_to/forward_of are mutually exclusive; reading the source needs message_read permission
11
- inboxes.drafts.get(inbox_id, draft_id)
12
- inboxes.drafts.update(inbox_id, draft_id, to?, cc?, bcc?, reply_to?, subject?, text?, html?, add_attachments?, remove_attachments?, add_labels?, remove_labels?, send_at?)
13
    * kind (plain/reply/forward) is fixed at create; omit=unchanged, null (or [] for recipients)=clear
14
    * send_at=null un-schedules; a draft already 'sending' can't be edited (409)
15
- inboxes.drafts.send(inbox_id, draft_id) — converts to Message, deletes draft
16
- inboxes.drafts.delete(inbox_id, draft_id)
17
- inboxes.drafts.list(inbox_id, limit?, page_token?, labels?)
18
- drafts.list(limit?, page_token?) — org-wide
19
20
Scheduled sending: pass send_at (ISO 8601 datetime) to create() or update().
21
Draft is auto-labeled 'scheduled' and sent at the specified time.
22
send_status: 'scheduled' | 'sending' | 'failed'.
23
Reschedule by updating send_at, un-schedule with send_at=None, or delete the draft.
24
25
Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
26
"""
27
import os
28
from datetime import datetime, timedelta
29
from dotenv import load_dotenv
30
from agentmail import AgentMail
31
32
load_dotenv()
33
client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
34
35
inbox_id = "agent@agentmail.to"
36
37
# Create and send immediately
38
draft = client.inboxes.drafts.create(inbox_id, to=["review@example.com"], subject="[REVIEW] Proposed reply")
39
sent = client.inboxes.drafts.send(inbox_id, draft.draft_id)
40
print(sent.message_id)
41
42
# Schedule for later
43
send_time = (datetime.utcnow() + timedelta(days=1)).replace(hour=9, minute=0, second=0)
44
scheduled = client.inboxes.drafts.create(
45
    inbox_id, to=["prospect@example.com"], subject="Follow up",
46
    text="Just following up...", send_at=send_time.isoformat() + "Z"
47
)
48
print(f"Scheduled for {scheduled.send_at}, status: {scheduled.send_status}")
49
50
all_drafts = client.drafts.list()