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

# Brevo

> Add Brevo to your Macaly project

Brevo (formerly Sendinblue) is an email marketing platform that also includes SMS, WhatsApp campaigns, and a built-in CRM. If you need more than just newsletters, Brevo bundles several communication channels into one tool.

<Callout icon="user">
  Available on all plans
</Callout>

<Note>
  **Do you actually need Brevo?** Macaly has a [built-in database](/en/features/databases) and email notifications. If you just need a contact form or waitlist, you don't need an external tool. Brevo is worth it when you need newsletters, automated sequences, SMS campaigns, or a CRM to manage your contacts.
</Note>

## Why use Brevo

* **Send newsletters and marketing emails.** Use the drag-and-drop editor or HTML templates without touching code.
* **Automate your follow-ups.** Build welcome series, abandoned cart emails, and re-engagement campaigns that run on their own.
* **Reach people across channels.** Send email, SMS, and WhatsApp campaigns from the same platform.
* **Manage contacts without a separate CRM.** Track deals and segment your audience all in one place.

## What you need

Before you start, make sure you have:

* A **Brevo account**. Create one for free at [brevo.com](https://www.brevo.com)
* A **contact list** in Brevo to collect subscribers into

There are two ways to connect Brevo to your site:

* **Embedded signup form.** Paste Brevo's generated form code into your site. Best for simple email collection.
* **Brevo API.** Connect your forms to Brevo's API for full control over what data you send. Best when you want custom forms that match your design.

## Option 1: Embedded signup form

The simplest approach. Brevo generates a form you can embed on your site.

<Steps>
  <Step title="Get your form embed code">
    In Brevo, go to **Contacts** then **Forms**. Create a new subscription form (or use an existing one), customize it, then copy the embed code.
  </Step>

  <Step title="Ask the agent to add it">
    Open the chat in your Macaly project and ask:

    ```
    Add this Brevo signup form to my site. Here's the embed code:

    [paste your Brevo embed code here]
    ```
  </Step>

  <Step title="The agent places the form">
    The agent adds the form to your project. Tell it where you want it: footer, sidebar, dedicated page, or a popup.
  </Step>
</Steps>

<Tip>
  If you want the form to match your site's design, tell the agent: *"Style the Brevo form to match the rest of my site."*
</Tip>

## Option 2: Custom form with Brevo API

For more control, the agent can build a custom form that sends subscribers to Brevo through their API.

<Steps>
  <Step title="Add your Brevo credentials to Secrets">
    Go to **Settings** then **Secrets** in your Macaly project. Add two secrets:

    * `BREVO_API_KEY` — your Brevo API key
    * `BREVO_LIST_ID` — the contact list you want subscribers added to

    <Accordion title="How to find your API key and list ID">
      **API key:**

      1. In Brevo, click your name in the top right, then **SMTP & API**
      2. Go to the **API Keys** tab
      3. Click **Generate a new API key** and copy it

      **List ID:**

      1. Go to **Contacts** then **Lists**
      2. Click the list you want to use
      3. Your **List ID** is shown in the URL and in the list details
    </Accordion>
  </Step>

  <Step title="Ask the agent to build the form">
    Open the chat and ask:

    ```
    Create a newsletter signup form in the footer. When someone subscribes,
    add them to my Brevo contact list using the API.
    I've added my API key and list ID to Secrets.
    ```
  </Step>
</Steps>

<Warning>
  Never paste API keys directly into the chat. Always use **Settings** then **Secrets** to store sensitive credentials. The agent can read them from there securely.
</Warning>

## Verify it's working

<Steps>
  <Step title="Submit a test signup">
    Visit your site and enter a test email address in the signup form.
  </Step>

  <Step title="Check your Brevo contacts">
    Go to **Contacts** in Brevo. Your test email should appear in the list you connected.
  </Step>
</Steps>

## Good to know

* If you only need to collect emails, Macaly's [built-in database](/en/features/databases) is simpler and doesn't require an external account
* For GDPR compliance, enable **double opt-in** in your Brevo form settings
* Brevo's API can also send transactional emails (order confirmations, password resets). Ask the agent if you need those too