Mass DM

Send a direct message to all verified members in a server. Supports variables, filters, and rate-limit-safe delivery.

Overview

Mass DM lets you send a direct message to every verified member in your server. Messages are delivered via Discord's DM API using each member's stored OAuth2 token. You can target all members or filter by role, account age, or join date.

Mass DM is available on Business and Enterprise plans.

Warning: Mass DM should be used responsibly. Sending spam or unsolicited promotional messages violates Discord's Terms of Service and can result in your bot being banned. Use Mass DM for important announcements, not advertising.

How to Send a Mass DM

1. Go to server settings → Mass DM tab (or use the dashboard member page).
2. Write your message. Supports variables (see below) and basic Markdown.
3. Apply filters if desired (role, minimum account age, joined after date).
4. Click "Preview" to see a sample of the message with variables filled in.
5. Click "Send" — you will be asked to confirm the number of recipients.
6. The job is queued and processed in the background. Progress is shown in the dashboard.

Message Variables

Use these placeholders in your message and they will be replaced with real values for each recipient:

| Variable | Replaced With |
|---|---|
| {{username}} | The member's Discord username |
| {{displayName}} | The member's display name (nickname if set) |
| {{serverName}} | Your server's name |
| {{date}} | Today's date (formatted) |

Example message:

Hey {{username}}, the {{serverName}} team has an important announcement for you. Check out our latest update at restorehub.net. — The Team

Filters

| Filter | Description |
|---|---|
| Role | Only members who have a specific Discord role |
| Account age | Only members whose Discord account is older than N days |
| Joined after | Only members who verified after a specific date |
| Joined before | Only members who verified before a specific date |

Rate Limits & Delivery

Discord limits how fast DMs can be sent. Restore Hub respects these limits and delivers messages at a safe rate. For large servers (10,000+ members), delivery may take several hours. You can monitor progress in real time from the dashboard.

Members who have disabled DMs from server members, or who have blocked the bot, will not receive the message. These are counted as "skipped" in the delivery report.

Delivery Report

After a Mass DM job completes, you receive a delivery report showing:

• Total recipients targeted
• Messages sent successfully
• Messages skipped (DMs closed or blocked)
• Messages failed (token expired or other error)

Usage Limits

| Plan | Mass DM Recipients / Month |
|---|---|
| Business | 50,000 |
| Enterprise | Unlimited |