name: zoom-mail
description: |
Zoom Mail API integration guide. Covers email services integrated with Zoom Workplace including
sending, reading, and managing email messages, folders, drafts, and attachments.
Use when building email integrations, automated messaging, or email management solutions
within the Zoom ecosystem.

Zoom Mail API

Build email integrations with Zoom Mail API for reading, sending, and managing email within Zoom Workplace.

Overview

Zoom Mail is an email service integrated into the Zoom platform that provides:
- Send and receive emails
- Folder management (inbox, sent, drafts, trash, etc.)
- Draft creation and management
- Attachment handling
- Message flagging and organization
- Mailbox settings configuration

Key Features

Choose Your Integration

Core Endpoints

Messages

Folders

Mailboxes

Attachments

Drafts

Common Operations

Send Email

const response = await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/messages`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: [{ email: '[email protected]', name: 'John Doe' }],
      subject: 'Meeting Follow-up',
      body: {
        content_type: 'text/html',
        content: '<p>Thank you for joining the meeting today.</p>'
      },
      cc: [],
      bcc: []
    })
  }
);

const message = await response.json();
// message.id contains the sent message ID

List Messages

const response = await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/messages?folder_id=inbox&page_size=50`,
  {
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

const messages = await response.json();
// messages contains inbox emails

Get Message Details

const response = await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/messages/${messageId}`,
  {
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

const message = await response.json();
// message contains full email details

Create and Send Draft

// Create draft
const draftResponse = await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/drafts`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: [{ email: '[email protected]', name: 'Jane Doe' }],
      subject: 'Draft Email',
      body: {
        content_type: 'text/plain',
        content: 'This is a draft message.'
      }
    })
  }
);

const draft = await draftResponse.json();

// Send draft
await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/drafts/${draft.id}/send`,
  {
    method: 'POST',
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

Download Attachment

const response = await fetch(
  `https://api.zoom.us/v2/mail/mailboxes/${mailboxId}/messages/${messageId}/attachments/${attachmentId}`,
  {
    headers: { 'Authorization': `Bearer ${accessToken}` }
  }
);

const attachmentBlob = await response.blob();
// attachmentBlob contains the file data

Standard Folders

Message Flags

Prerequisites

1. Zoom Mail enabled - Users need Zoom Mail service enabled
2. OAuth app - Create in Zoom App Marketplace
3. Mail scopes - Request appropriate mail permissions

Common Use Cases

Required Scopes

Resources

• Official docs: https://developers.zoom.us/docs/zoom-mail/
• API Reference: https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#tag/Mail
• Marketplace: https://marketplace.zoom.us/