# Set Up Brevo

> Brevo works well when you already manage your sender identities there — connect Mailrith with an API key and let Brevo handle delivery while Mailrith manages campaigns and subscriber targeting.

- Human page: https://mailrith.com/docs/setup-brevo
- Category: Campaigns & Delivery
- Reading time: 8 min read

## What this guide covers
Connect Brevo using a transactional API key and a verified sender identity, then configure the Brevo webhook for bounce and spam event tracking.

## Sections
- Before You Start
- Mailrith Fields
- Brevo Setup
- Webhooks and Test Send

## Visual Reference
![Mailrith email delivery connections page showing connected providers with action controls.](https://mailrith.com/docs/screenshots/email-delivery-connections.png)

The Email Delivery Connections page lists every connected provider. From here you can add a new connection, send a test email, view webhook endpoints, and assign connections to workspaces.

## Before You Start

Brevo connects to Mailrith with an API key and a sender identity already allowed in Brevo. Before creating the connection, prepare:

- **A verified sender or domain:** Brevo must allow the From email you plan to use.
- **A Brevo API key:** Mailrith uses this key to send email.
- **Permission to configure webhooks:** needed for bounce, blocked, invalid, spam, and complaint events.
- **A test recipient:** use it to confirm Mailrith can send through Brevo before live campaigns use the connection.

If your Brevo account uses separate settings for transactional email, confirm the sender and API key work for the type of email you want Mailrith to send.

## Mailrith Fields

In Mailrith, click [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in the left sidebar, click **Create Connection**, choose **Brevo** in **Select Email Delivery Service**, and enter these fields in **Connect Email Delivery Service**:

- **Connection name:** an internal label, such as "Brevo Campaign Sender".
- **API Key:** the Brevo key used for sending.
- **From name:** the sender name subscribers see.
- **From email:** the sender address approved in Brevo.
- **Workspaces:** the Mailrith workspaces that can use this connection.

## Brevo Setup

1. Sign in to Brevo and open the account that should send Mailrith email.
2. Confirm the sender identity first. Open the sender or domain settings in Brevo and make sure the From email you plan to use in Mailrith is verified or belongs to a verified domain.
3. If the sender is not verified yet, add the sender email or domain in Brevo and complete Brevo's verification steps before testing Mailrith.
4. Open Brevo's **SMTP & API** settings.
5. Open the **API Keys** area and create a new API key.
6. Name the key clearly, such as **Mailrith sending**, so teammates know what uses it later.
7. Create the key and copy it immediately. Brevo may only show the full key at creation time.
8. Return to [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in Mailrith, click **Create Connection**, and choose **Brevo**.
9. Paste the API key, enter the From name, enter the Brevo-approved From email, assign workspaces, and click **Save**.
10. Use **Send Test Email** from the connection row before using the connection in a real send.

If the test fails, check the sender identity, API key, Brevo account status, and whether the selected From email is allowed for the Brevo email product your account is using.

## Webhooks and Test Send

Brevo can send bounce, blocked, invalid, spam, and complaint events to Mailrith. Mailrith uses these to mark affected subscribers as Bounced or Complained.

1. In Mailrith, click **Email Delivery Connections**, click **Webhooks** on the Brevo connection, and copy the delivery-event webhook URL.
2. In Brevo, open the webhook settings for email or transactional email events.
3. Create a new webhook and paste the Mailrith delivery-event URL as the endpoint.
4. Enable bounce, blocked, invalid email, spam, and complaint-style events. These are the events Mailrith needs most because they protect future sends from bad or risky addresses.
5. Save the webhook and confirm it is enabled.
6. After the next test or small send, check Brevo's webhook delivery history if Mailrith does not show the event you expected.

If events do not appear in Mailrith, confirm the webhook is enabled, the exact Mailrith URL was used, and Brevo is sending the selected event types for messages from this connection.

## Related Guides
- [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md): Mailrith is provider-agnostic — you connect your own email delivery service and Mailrith handles campaign logic, subscriber targeting, and engagement tracking on top of it.
- [Broadcasts](https://mailrith.com/docs/broadcasts.md): Broadcasts are for newsletters, product launches, announcements, and any message that goes out once to selected subscribers — compose, target, test, and send or schedule from a single workflow.
- [Sequences](https://mailrith.com/docs/sequences.md): Sequences send a series of emails over time as subscribers progress through the steps — ideal for onboarding, nurture campaigns, and educational content that should unfold over days or weeks.