# Brevo SMTP Relay

First you need to [download AcyMailing](https://www.acymailing.com/#download) from our website.

Once done, select Brevo in the first tab of the configuration:

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FCuBLRvGtgh4g7R6ZI6xL%2Fjoomla_4_2_6_-_Administration.png?alt=media\&token=4b28480e-f346-448b-8789-a96ca6ffd183)

### New SMTP Key

Then to send emails you'll need to create a new SMTP Key on brevo.\
Here is how you get it:

Log into your Brevo account and go to SMTP & API menu:

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FT2erzLbLjAdS1tuqOcgs%2Fbrevo_smtp_key_listing.png?alt=media\&token=11d8cfdb-c87c-48bc-a5fd-f55787349490)

Once you're on this listing, you can either copy an existing API key or create a new one by clicking on the **Generate a new SMTP key** button and set a **name** for it:

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2Fl6ZX1rMSfBrF4UJRfHLd%2Fbrevo_set_smtp_key.png?alt=media\&token=3efd6f58-e396-4e7c-8cb7-fe62cc3d19dd)

Please copy you SMTP key it wont be show again.

### AcyMailing Configuration

Now that you have setup you Brevo SMTP key, you need to set it in AcyMailing.

Go to the AcyMailing configuration under the tab Mail Settings and select Brevo as your sending method.

You have to field to set, the first one is the Brevo identifier, you can find it on your Brevo account under **SMTP & API**:

<figure><img src="https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FlDJEkwS2SxG1H6bAWwEr%2Fbrevo_identifier.png?alt=media&#x26;token=fc8dfa7f-80c6-450e-8694-3d2efc2269ca" alt=""><figcaption></figcaption></figure>

Then you can paste your SMTP Key generated above in the second field.

<figure><img src="https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FkovFARqGLfexWQ7Gd4ZC%2Fbrevo_new_configuration.png?alt=media&#x26;token=5d095cb8-d27c-4d98-8ae3-3564ae6b8b27" alt=""><figcaption></figcaption></figure>

### Handle users with hard bounce or unsubscribing from Brevo

Brevo withholds bounce messages, and since you must not try to send an email to someone that generated a hard bounce (email address does not exist for example) or to someone that unsubscribed on the Brevo side, you will need to create a webhook on your Brevo account.

This webhook will call AcyMailing to forward the information, so that AcyMailing takes it into account in the statistics and disables the user.

First go in the menu Transactional => Settings => Webhook:

<figure><img src="https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FS5dblRer4onM5uNVsj6V%2Fimage.png?alt=media&#x26;token=b7cdd5c9-2669-4337-8742-51cce290f9e4" alt="" width="375"><figcaption></figcaption></figure>

Click on the "Add a new webhook" button to create your webhook, then select the triggers "Complaint", "Hard Bounce" and "Unsubscribed":

<figure><img src="https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FkHGjfYk6GSuIzkk31ytu%2Fimage.png?alt=media&#x26;token=b902b679-ddd6-4ccb-a7ee-455a160a4acb" alt="" width="563"><figcaption></figcaption></figure>

For the URL to call, it depends on the type of website you have.

For WordPress:&#x20;

```
https://MY.SITE/index.php?page=acymailing_front&ctrl=frontservices&task=sendinblue&noheader=1&seckey=XXXXXXXXXXXXX
```

For Joomla:

```
https://MY.SITE/index.php?option=com_acym&ctrl=frontservices&task=sendinblue&seckey=XXXXXXXXXXXXX
```

In both cases, replace "MY.SITE" by your site URL and "XXXXXXXXXXXXX" by the security key stored in the "Security" tab of the AcyMailing configuration page:

<figure><img src="https://963725040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L_D4iy53WFAtKVs3BPA-3566562695%2Fuploads%2FYXREC1xLkKQdt2ErFZH1%2Fimage.png?alt=media&#x26;token=8317765f-67d0-4b56-b300-202d59be41ac" alt=""><figcaption></figcaption></figure>

Once created, the webhook will be used by Brevo whenever a user must be disabled in AcyMailing. You can see how many times the webhook has been triggered on the webhooks listing.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acymailing.com/external-sending-method/sendinblue.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
