Labels
Labels mark message state and campaign tags: unread, spam, trash, or your own keys.
Message
Parent
Label
This guide
Built-in and custom
Apply labels on send or with a PATCH. Filter lists with ?labels=. Spam, blocked, and trash visibility depend on API key permissions.
| Label | Use |
|---|---|
| unread | Inbound not yet processed. |
| spam | Suspected junk; requires label_spam_read. |
| ignored | Inbound from an ignore-list number. |
await agentcell.messages.update({ cellId, messageId, addLabels: ["unread"] });Common errors
- VALIDATION_ERROR
Unknown label or missing permission.
Copy for Cursor / Claude
Tag inbound as unread, then filter.
curl "https://api.agentcell.store/v1/cells/$CELL_ID/messages?labels=unread" -H "Authorization: Bearer $AGENTCELL_API_KEY"