Managing Segments
Learn how to create, retrieve, and delete Segments.
Segments are used to organize your Contacts into groups for sending Broadcasts. Segments are not visible to your Contacts. They are only used for your own internal Contact management.
Create Segments
Section titled “Create Segments”You can create Segments in the Dashboard, or programmatically from the Segments API, with a Segments CLI command, or MCP.
To create a Segment in the Resend Dashboard:
Go to the **Segments** Dashboard view.
Select **Create Segment**.
Enter a name.
Enter a name for your Segment that describes the Contacts in this group (e.g., "newsletter subscribers", "free trial users").
Click **Add** to confirm.
View Segments
Section titled “View Segments”The Segments Dashboard view shows a list of all Segments in your account, when they were created, and how many Contacts are in each Segment.
Edit Segments
Section titled “Edit Segments”Click the More options menu next to each Segment to:
- edit the Segment name
- copy the Segment ID to your clipboard
- delete the Segment
Click on any Segment to view the list of Contacts that belong to that Segment.
You can also retrieve a single Segment, list of Segments, or the list of Contacts in a Segment, from the Segments API, with a Segments CLI command, or MCP.
Updating the Segments of a Contact
Section titled “Updating the Segments of a Contact”A Contact can belong to multiple Segments. Because Segments are only used to organize your Contacts internally for sending Broadcasts, you do not need consent to add a user to a Segment.
You can add a Contact to a Segment via the Dashboard by editing the Contact and choosing to add or remove Segments.
You can also use the Contacts API or Contacts CLI commands to add or remove Segments from a Contact's profile programmatically.
Delete Segments
Section titled “Delete Segments”When you delete a Segment, no Contacts are deleted. The Segment is removed from your list, and from the segments property of all associated Contacts.
You can delete Segments in the Dashboard, or programmatically from the Segments API, with a Segments CLI command, or with MCP.
To delete one or more Segments in the Dashboard:
Go to the **Segments** Dashboard view.
Select the Segment(s) you want to delete by clicking the checkboxes next to each Segment.
Click **Delete** in the bottom action bar.
Type the Segment name (for single selection) or `DELETE N SEGMENTS` (for multiple) to confirm.
Press **Cmd+Enter** or click **Delete Segments** to complete.
You can also use keyboard shortcuts:
- Cmd+A to select all Segments on the current page.
- Backspace to open the delete confirmation modal.
Export your data
Section titled “Export your data”Admins can download your data in CSV format for the following resources:
- Emails
- Broadcasts
- Contacts
- Segments
- Domains
- Logs
- API keys
To start, apply filters to your data and click on the "Export" button. Confirm your filters before exporting your data.
If your exported data includes 1,000 items or less, the export will download immediately. For larger exports, you'll receive an email with a link to download your data.
All admins on your team can securely access the export for 7 days. Unavailable exports are marked as "Expired."
API Reference
Section titled “API Reference”For complete API documentation, see the Segments API reference.