/onebox returns 404 {"error":"Endpoint not found"}, and a wrong method returns 405 {"error":"Method not allowed"}.{ "success": ... } JSON, not the standard status, message and data envelope. Errors use the standard error envelope.connected-accounts and search-emails default to a limit of 50 (maximum 100), thread-emails to 100, and top-emails uses cursor pagination with no page.workspaceIds (comma-separated) limits a search to those workspaces; IDs you do not have access to are dropped. It defaults to all your workspaces.| Task | Endpoint |
|---|---|
| List mailboxes available in Zapbox | List Zapbox Connected Accounts |
| List threads (inbox view) | List Zapbox Threads |
| Read all messages of one thread | Get Zapbox Thread Messages |
| Search messages | Search Zapbox Emails |
| Star, read, archive, move, label or trash messages | POST /onebox/action |
| Send or schedule an email | Send Zapbox Email |
| Download an attachment | Download Zapbox Attachment |
| Create a label | Create Zapbox Label |
| Rename a label | Rename Zapbox Label |
| Delete a label | Delete Zapbox Label |
account value in the other calls.nextCursor of the previous response as cursor; it is null on the last page. Warm-up threads are excluded unless warmup is true.threadId returns every message oldest first, with bodies and attachment metadata.attachmentId, messageId, provider and account, which must be in the query string even though it is a POST. The response body is the raw file.from, subject, dateWithin, isRead and hasAttachment. All filters combine with AND, and the response is a plain array with no total.threadId and messageId to reply in a thread. With isScheduled true the email is sent at scheduledAt and the response is 202; a scheduled email cannot be cancelled through the API. Attachments cannot be sent through this API.POST /onebox/action applies star, unstar, read, unread, archive, move, addLabel, removeLabel, trash, restore, unarchive, done or undone. Choose messages with threadMessages (thread ID to message IDs), or send an empty threadMessages with a filter that includes at least one of folder, accounts or before. Up to 5 threads are updated before the response (200). More than 5 threads, or any filter-based request, is queued and returns 202 with queued: true.POST /onebox/action and action addLabel. Rename Zapbox Label and Delete Zapbox Label change the label for all your mailboxes but update messages only in the mailbox given as account, up to 10,000 messages per call. Deleting a label cannot be undone.