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
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 cancel by deleting the draft entirely
10
client.inboxes.drafts.delete(
11
    inbox_id="outreach@domain.com",
12
    draft_id=scheduled_draft.draft_id
13
)

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?, send_at?)
8
- inboxes.drafts.get(inbox_id, draft_id)
9
- inboxes.drafts.update(inbox_id, draft_id, to?, subject?, text?, html?, send_at?, ...)
10
- inboxes.drafts.send(inbox_id, draft_id) — converts to Message, deletes draft
11
- inboxes.drafts.delete(inbox_id, draft_id)
12
- inboxes.drafts.list(inbox_id, limit?, page_token?, labels?)
13
- drafts.list(limit?, page_token?) — org-wide
14
15
Scheduled sending: pass send_at (ISO 8601 datetime) to create() or update().
16
Draft is auto-labeled 'scheduled' and sent at the specified time.
17
send_status: 'scheduled' | 'sending' | 'failed'.
18
Cancel by deleting the draft. Reschedule by updating send_at.
19
20
Errors: SDK raises on 4xx/5xx. Rate limit: 429 with Retry-After.
21
"""
22
import os
23
from datetime import datetime, timedelta
24
from dotenv import load_dotenv
25
from agentmail import AgentMail
26
27
load_dotenv()
28
client = AgentMail(api_key=os.getenv("AGENTMAIL_API_KEY"))
29
30
inbox_id = "agent@agentmail.to"
31
32
# Create and send immediately
33
draft = client.inboxes.drafts.create(inbox_id, to=["review@example.com"], subject="[REVIEW] Proposed reply")
34
sent = client.inboxes.drafts.send(inbox_id, draft.draft_id)
35
print(sent.message_id)
36
37
# Schedule for later
38
send_time = (datetime.utcnow() + timedelta(days=1)).replace(hour=9, minute=0, second=0)
39
scheduled = client.inboxes.drafts.create(
40
    inbox_id, to=["prospect@example.com"], subject="Follow up",
41
    text="Just following up...", send_at=send_time.isoformat() + "Z"
42
)
43
print(f"Scheduled for {scheduled.send_at}, status: {scheduled.send_status}")
44
45
all_drafts = client.drafts.list()