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

# Broadcasts

> Learn how to send emails to your contacts

Broadcasts let you send emails to your subscribed contacts at once.

<video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/nosubs/W2E8XF1wdp7HKe4u/assets/broadcasts.mp4?fit=max&auto=format&n=W2E8XF1wdp7HKe4u&q=85&s=fdea94f15a3c278f396f8518138a7751" data-path="assets/broadcasts.mp4" />

1. Click the **Create Broadcast** button from the navigation panel
2. Choose a verified sender from the **From** field dropdown
3. Write your email subject line and compose your content in the editor
4. Click **Send Email** and configure your quota usage settings (see [Quota Configuration](#quota-configuration) below)
5. Click **Send** to start sending to all subscribed contacts
6. Monitor your email performance with metrics including delivery rate, bounce rate, open rate, and click rate

## Quota Configuration

Since broadcasts can consume large amounts of your quota, it's important to control how much capacity they use. This prevents a single broadcast from using your entire quota.

AWS SES enforces two types of limits on your account:

* **Daily quota**: Maximum number of emails you can send in a 24-hour period
* **Send rate**: Maximum number of emails you can send per second

When you configure a broadcast's quota usage percentage, the system proportionally allocates both limits. For example, if you set 50% quota usage and your account has a 50,000 daily quota with 14 emails/second send rate, the broadcast will use 25,000 emails/day and 7 emails/second.

## Unsubscribe Handling

The system provides multiple layers of unsubscribe functionality to ensure compliance and maintain a healthy sender reputation:

### Automatic Unsubscription

Contacts are automatically unsubscribed when AWS SES reports a bounce or complaint event. This helps protect your sender reputation and ensures you don't continue sending to invalid or unwilling recipients.

### Manual Unsubscribe Options

We provides two ways that allow users to unsubscribe manually.

<video autoPlay muted loop playsInline className="w-full rounded-xl" src="https://mintcdn.com/nosubs/p6m1th_FZ-laVwWy/assets/broadcasts-unsubscribe-footer.mp4?fit=max&auto=format&n=p6m1th_FZ-laVwWy&q=85&s=373c0df97a4766bf6db3074058994e59" data-path="assets/broadcasts-unsubscribe-footer.mp4" />

1. **Unsubscribe footer (your responsibility)**: You should manually include an unsubscribe link in your email content.
   The editor provides an unsubscribe block that you can insert.
   The unsubscribe link must be `https://getsendbase.com/unsubscribe?token={{unsubscribeToken}}` to properly identify and unsubscribe recipients

2. **Unsubscribe headers (automatic)**: The system automatically adds unsubscribe headers to every email. These headers allow email clients to display built-in unsubscribe options, providing an additional compliance layer.

## Broadcast Statuses

Here are all the statuses that a broadcast can have:

* `draft`: The broadcast is being composed
* `queued`: The broadcast is waiting to be processed for sending
* `in_progress`: The broadcast is currently being sent to contacts
* `published`: The broadcast has been successfully sent to all contacts
* `paused`: The system paused the publishing process

## Limitations

### Template Variables

Broadcasts currently do not support template variables for personalization beyond the built-in `{{unsubscribeUrl}}` and `{{unsubscribeToken}}` variables.

This limitation exists because the **GetContact** API retrieving contact has a rate limit of 1 request per second, making it impractical to fetch personalization data when sending to thousands of contacts.