MailgentConcepts
Labels
Organize messages with labels
Labels are string tags attached to messages. They help agents track message state.
Default Labels
| Label | Applied when |
|---|---|
received | Inbound email arrives |
unread | Inbound email arrives (paired with received) |
sent | Outbound email is sent |
Custom Labels
You can add any custom labels:
curl -X PATCH https://api.mailgent.dev/v0/messages/{messageId} \
-H "Authorization: Bearer mgent-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"addLabels": ["read", "processed", "high-priority"],
"removeLabels": ["unread"]
}'Filtering by Labels
# Get all unread messages
GET /v0/messages?labels=unread
# Get all sent messages
GET /v0/messages?labels=sent
# Get messages with multiple labels (AND filter)
GET /v0/messages?labels=received,high-priorityCommon Agent Patterns
| Pattern | Labels |
|---|---|
| Mark as read | Add read, remove unread |
| Flag for review | Add needs-review |
| Mark as processed | Add processed, remove unread |
| Archive | Add archived |
| Priority | Add high-priority or low-priority |