Use the Mailing Lists feature to send release notes emails

Shipstar's Mailing Lists feature lets you build a list of subscribers and deliver Release Notes Email content to them directly. This is the built-in way to keep your users informed every time you ship, without needing a separate email platform for your release communications.

How mailing lists work

A mailing list is a collection of recipient email addresses associated with your project. When you generate and publish a Release Notes Email, Shipstar can deliver it to the subscribers on your list. You manage recipients through the dashboard's mailing list panel, which includes filtering so you can find and remove addresses easily.

Managing recipients in the dashboard

1. Open Destinations in the dashboard sidebar and navigate to your mailing list.
2. Use the filterable panel to search for existing recipients by email address.
3. To add a recipient, enter their email address and confirm. To remove one, find them in the list and delete the entry.
4. Recipients you add will receive future Release Notes Email deliveries for this project.

Adding recipients programmatically

You can bulk-add recipients using the public V1 API:

POST /api/v1/mailing-lists/{list_id}/recipients

This endpoint requires a Bearer token in the Authorization header. It is rate-limited to 30 requests per minute — if you exceed this, the API returns 429 Too Many Requests with a Retry-After header telling you how long to wait. For large imports, batch your requests and add a short delay between them. See the API Overview for rate limit headers and error handling guidance.