/v1/mailboxesRead the workspace's connected mailboxes
Every mailbox this workspace has connected: the provider (gmail or outlook), the address, whether the connection is proven, and when it last synced. A MAILBOX HERE IS A WATCHED INBOX — the account mail arrives at — not a folder of mail and not a thread: to read what was said, get_comms_conversations and get_comms_texts. It is not the list of addresses anybody may send from: a seat's own connected email account sends without being listed here, so an empty list does not mean email cannot go. "What can I send from" is get_comms_senders.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Responses
the action's answer
{
"data": [
{
"address": "string",
"connection_id": "",
"created_at": "2026-01-01T00:00:00Z",
"id": "",
"mine": true,
"provider": "string",
"source": "string",
"watching": true
}
]
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}