> ## Documentation Index
> Fetch the complete documentation index at: https://nuntly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Broadcast overview

> Send one email to a list of contacts. Understand how contacts, segments, topics, templates, and broadcasts fit together, and when to use Broadcast instead of transactional sending.

Broadcast sends one email to many contacts that you store in Nuntly. You keep a contact list, choose who receives each send with segments and topics, write the content once in a template, and start the send. Every message includes an unsubscribe link automatically, contacts who opted out do not receive the send, and delivery is paced.

> [!NOTE]
>
> Broadcast is available to every organization. You manage it through the API or the Broadcast section of the dashboard. See [Set up Broadcast](https://nuntly.com/docs/guides/broadcast-setup.md) for the prerequisites.

## Broadcast or transactional sending

Use transactional sending when your application triggers a message for one person, such as a password reset or an order confirmation. Use Broadcast when you send one message to a list: the content comes from a single template, and contact properties personalize it for each recipient.

| Email | Use | Why |
| - | - | - |
| Email verification, sign-in link, password reset | Transactional sending | Triggered by one person's action in your application. |
| Order confirmation, receipt, invoice | Transactional sending | Tied to one transaction for one person. |
| Account or usage alert | Transactional sending | About one person's account. |
| Product update, feature announcement | Broadcast | Sent to the users of your product, stored as contacts. |
| Newsletter | Broadcast | Sent to contacts who subscribed to it. |
| Cold outreach to prospects | Not allowed | Unsolicited bulk email and purchased or scraped lists are prohibited by the [Terms of Service](https://nuntly.com/legal/terms-of-service#prohibited). |

Transactional sending takes the recipients and the content in each request. See [Send your first email](https://nuntly.com/docs/guides/send-your-first-email.md) and [Bulk email sending](https://nuntly.com/docs/guides/bulk-email-sending.md). Broadcast sends a published template version to contacts stored in Nuntly, optionally narrowed by a segment and a topic, now or later. Every broadcast message carries an unsubscribe link and the one-click unsubscribe headers.

Both types respect the [suppression list](https://nuntly.com/docs/guides/broadcast-unsubscribe.md#suppression-list). Only Broadcast respects unsubscribes.

## How the pieces fit together

**1. Add contacts**

A contact is an email address in your organization. You can store custom [contact properties](https://nuntly.com/docs/guides/broadcast-segments.md#contact-properties) on it.

**2. Group contacts**

Put contacts in [segments](https://nuntly.com/docs/guides/broadcast-segments.md#segments) to target a subset of your list. Use [topics](https://nuntly.com/docs/guides/broadcast-segments.md#topics) to let contacts opt out of one kind of message without leaving your list.

**3. Write a template**

A [template](https://nuntly.com/docs/guides/broadcast-templates.md) holds versions of your content. You publish a version to make it the active one.

**4. Create and send a broadcast**

A [broadcast](https://nuntly.com/docs/guides/broadcast-sending.md) ties a sender address, a template, and an optional segment and topic together. You send it now or later.

**5. Follow delivery**

The broadcast moves through a [status lifecycle](https://nuntly.com/docs/guides/broadcast-sending.md#status-lifecycle). Each recipient has a send record, and the email events for a recipient carry the broadcast id.

## Next steps

> [card] [Set up Broadcast](https://nuntly.com/docs/guides/broadcast-setup.md)
>
> Domain choice, domain requirements, and API key permissions

> [card] [Create and send a broadcast](https://nuntly.com/docs/guides/broadcast-sending.md)
>
> Scheduling, statuses, recipients, and events

> [card] [Contacts, segments, and topics](https://nuntly.com/docs/guides/broadcast-segments.md)
>
> Manage your list and choose who receives a broadcast

> [card] [Templates](https://nuntly.com/docs/guides/broadcast-templates.md)
>
> Versions, publishing, and what freezes when

> [card] [Unsubscribe and suppression](https://nuntly.com/docs/guides/broadcast-unsubscribe.md)
>
> The unsubscribe link, one-click unsubscribe, and the suppression list


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.