Mail360 API Guide
Mail360 offers a platform to connect and/or host the mailboxes in your application. The universal APIs ensure that you are able to access multiple providers from a single place. We offer a wide range of APIs to work with accounts, messages, attachments, folders, and labels.
Accounts API
Accounts in Mail360 are nothing but the mailboxes you connect or host with us. Accounts APIs provide you with the capability to manage and perform actions on the accounts you've integrated with Mail360.
| API | URL | Method | OAuth Scope |
| Add native account | /api/accounts | POST | MailApps.accounts |
| Add sync account | /api/accounts | POST | |
| Add sync account using OAuth | /api/accounts/oauth | POST | |
| Enable account | /api/accounts/{account_key} | PUT | |
| Disable account | /api/accounts/{account_key} | PUT | |
| Get all Accounts | /api/accounts | GET | |
| Get specific account | /api/accounts/{account_key} | GET | |
| Update password | /api/accounts/{account_key} | PUT | |
| Delete account | /api/accounts/{account_key} | DELETE |
Messages API
In this context, emails are referred to as messages. The Messages APIs give you the tools to manage and conduct operations related to the messages within your accounts.
| API | URL | Method | OAuth Scope |
| Send emails | /api/accounts/{account_key}/messages | POST | MailApps.messages |
| Send reply | /api/accounts/{account_key}/messages/{messageId} | POST | |
| Mark emails as read | /api/accounts/{account_key}/messages | PUT | |
| Mark emails as unread | /api/accounts/{account_key}/messages | PUT | |
| List emails in a folder | /api/accounts/{account_key}/messages | GET | |
| List emails based on search key | /api/accounts/{account_key}/messages/{messageId} | GET | |
| Get specific email | /api/accounts/{account_key}/messages/{messageId} | GET | |
| Get specific message content | /api/accounts/{account_key}/messages/{messageId} | GET | |
| Get specific message header | /api/accounts/{account_key}/messages/{messageId} | GET | |
| Get attachment details | /api/accounts/{account_key}/messages/{messageId}/ | GET | |
| Move emails | /api/accounts/{account_key}/messages | PUT | |
| Flag emails | /api/accounts/{account_key}/messages | PUT | |
| Apply labels | /api/accounts/{account_key}/messages | PUT | |
| Remove specific labels | /api/accounts/{account_key}/messages | PUT | |
| Remove all labels | /api/accounts/{account_key}/messages/ | PUT | |
| Delete email | /api/accounts/{account_key}/messages/{messageId} | DELETE |
Attachments API
The Attachments APIs provide you with the capability to upload and download the attachments in your emails.
| API | URL | Method | OAuth Scope |
| Download attachment | /api/accounts/{account_key}/messages/ {messageId}/attachments/{attachmentId} | GET | MailApps.attachments |
| Upload attachment | /api/accounts/{account_key}/attachments | POST |
Folders API
Folders allow you to organize your emails in your account. The Folders APIs provide you with the capability to manage and perform actions on the folders.
| API | URL | Method | OAuth Scope |
| Create folder | /api/accounts/{account_key}/folders | POST | MailApps.folders |
| Get all folders | /api/accounts/{account_key}/folders | GET | |
| Get specific folder | /api/accounts/{account_key}/folders/{folderId} | GET | |
| Mark folder as read | /api/accounts/{account_key}/folders/{folderId} | PUT | |
| Move folder | /api/accounts/{account_key}/folders/{folderId} | PUT | |
| Rename folder | /api/accounts/{account_key}/folders/{folderId} | PUT | |
| Delete emails in a folder | /api/accounts/{account_key}/folders/{folderId} | PUT | |
| Delete folder | /api/accounts/{account_key}/folders/{folderId} | DELETE |
Labels API
Labels allow you to categorize your emails in your account. The Labels APIs provide you with the capability to manage and perform actions on the labels.
| API | URL | Method | OAuth Scope |
| Create label | /api/accounts/{account_key}/labels | POST | MailApps.tags |
| Get all labels | /api/accounts/{account_key}/labels | GET | |
| Get specific label | /api/accounts/{account_key}/labels/{labelId} | GET | |
| Update label | /api/accounts/{account_key}/labels/{labelId} | PUT | |
| Delete label | /api/accounts/{account_key}/labels/{labelId} | DELETE |
Drafts API
Drafts enable you to save and review unfinished messages before sending, ensuring both clarity and completeness. The Drafts API allows you to manage these drafts and perform actions on them.
| API | URL | Method | OAuth Scope |
| Create draft | /api/accounts/{account_key}/drafts | POST | MailApps.messages |
| Send email using draft | /api/accounts/{account_key}/drafts/{draftId} | POST | |
| Get all drafts | /api/accounts/{account_key}/drafts | GET | |
| Get specific draft | /api/accounts/{account_key}/drafts/{draftId} | GET | |
| Update draft | /api/accounts/{account_key}/drafts/{draftId} | PUT | |
| Delete draft | /api/accounts/{account_key}/drafts/{draftId} | DELETE |
Templates API
An email template is a ready-to-use format that you can customize by replacing its content with your own. The Templates API allows you to manage these templates and perform actions on them.
| API | URL | Method | OAuth Scope |
| Create template | /api/accounts/{account_key}/templates | POST | MailApps.messages |
| Get all templates | /api/accounts/{account_key}/templates | GET | |
| Get specific template | /api/accounts/{account_key}/templates/{templateId} | GET | |
| Update template | /api/accounts/{account_key}/templates/{templateId} | PUT | |
| Delete template | /api/accounts/{account_key}/templates/{templateId} | DELETE |
Threads API
While the Messages APIs focus on individual messages, the Threads APIs deal with entire conversation threads, each of which contains multiple messages. The Threads APIs allow you to manage these threads and perform actions on them.
| API | URL | Method | OAuth Scope |
| Get all threads | /api/accounts/{account_key}/threads | GET | MailApps.messages |
| Get specific thread | /api/accounts/{account_key}/threads/{threadId} | GET | |
| Mark threads as read/unread | /api/accounts/{account_key}/threads | PUT | |
| Move threads | /api/accounts/{account_key}/threads | PUT | |
| Flag threads | /api/accounts/{account_key}/threads | PUT | |
| Label threads | /api/accounts/{account_key}/threads | PUT | |
| Remove specific labels | /api/accounts/{account_key}/threads | PUT | |
| Remove all labels | /api/accounts/{account_key}/threads | PUT | |
| Delete a thread | /api/accounts/{account_key}/threads/{threadId} | DELETE | |
| Delete threads | /api/accounts/{account_key}/threads | DELETE |