How do I use labels to track email state?

1
client.inboxes.messages.send(
2
    inbox_id="agent@yourdomain.com",
3
    to=["prospect@example.com"],
4
    subject="Quick question",
5
    text="Hi, I wanted to ask about...",
6
    html="<p>Hi, I wanted to ask about...</p>",
7
    labels=["outreach", "first-touch", "tech-vertical"]
8
)

1
# Mark a message as processed
2
client.inboxes.messages.update(
3
    inbox_id="agent@yourdomain.com",
4
    message_id=msg.message_id,
5
    add_labels=["processed", "positive-sentiment"],
6
    remove_labels=["unread"]
7
)

1
# Get all unread messages in an inbox
2
unread = client.inboxes.messages.list(
3
    inbox_id="agent@yourdomain.com",
4
    labels=["unread"]
5
)
6
7
# Get threads that need a follow-up from a specific campaign
8
follow_ups = client.inboxes.threads.list(
9
    inbox_id="agent@yourdomain.com",
10
    labels=["q4-campaign", "needs-response"]
11
)
12
13
# Get escalations that need human review
14
escalations = client.inboxes.messages.list(
15
    inbox_id="agent@yourdomain.com",
16
    labels=["escalation", "needs-human-review"]
17
)

1
from agentmail import AgentMail
2
3
client = AgentMail()
4
5
# Find threads that need a reply
6
unreplied = client.inboxes.threads.list(
7
    inbox_id="support@yourdomain.com",
8
    labels=["unreplied"]
9
)
10
11
for thread_item in unreplied.threads:
12
    # Get the full thread
13
    thread = client.threads.get(thread_id=thread_item.thread_id)
14
    last_message = thread.messages[-1]
15
    
16
    # Classify the message (your agent logic here)
17
    category = classify(last_message.extracted_text or last_message.text)
18
    
19
    if category == "needs-human":
20
        # Escalate: add label, skip auto-reply
21
        client.inboxes.messages.update(
22
            inbox_id="support@yourdomain.com",
23
            message_id=last_message.message_id,
24
            add_labels=["needs-human-review", "escalation"],
25
            remove_labels=["unreplied"]
26
        )
27
    else:
28
        # Auto-reply and mark as handled
29
        reply_text = generate_reply(last_message, category)
30
        client.inboxes.messages.reply(
31
            inbox_id="support@yourdomain.com",
32
            message_id=last_message.message_id,
33
            text=reply_text
34
        )
35
        client.inboxes.messages.update(
36
            inbox_id="support@yourdomain.com",
37
            message_id=last_message.message_id,
38
            add_labels=["replied", "processed", category],
39
            remove_labels=["unreplied"]
40
        )