Set Up Brevo

Before You Start

To connect Brevo to Mailrith, you need an API key and a sender identity that Brevo already allows. Before you create 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: You need this permission so Mailrith can receive bounce, blocked, invalid, spam, and complaint events.
• A test recipient: Use this recipient to confirm Mailrith can send through Brevo before live campaigns use the connection.

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

Mailrith Fields

In Mailrith, click Email Delivery Connections in the left sidebar, click Create Connection, choose Brevo in Select Email Delivery Service, and enter the following 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 check that 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 you test 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 the key later.
7. Create the key and copy it immediately. Brevo may show the full key only at creation time.
8. Return to Email Delivery Connections 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. From the saved connection row, click Send Test Email and confirm the test recipient receives the message before you use the connection for a real send.

If the test fails, check that the sender identity is verified, the API key was copied correctly, the Brevo account can send email, and 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 events 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. Mailrith needs these event types most because they protect future sends from bad or risky addresses.
5. Save the webhook and confirm Brevo shows the webhook as enabled.
6. After the next test or small send, check Brevo's webhook delivery history if Mailrith does not show the expected delivery event.

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