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

# Brevo

> Send transactional email and manage contacts, lists, and campaigns in Brevo

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `BREVO_API_KEY` is sent as the `api-key` header.
* **Docs**: [https://developers.brevo.com/docs/getting-started](https://developers.brevo.com/docs/getting-started)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable        | Required | Description                                                                                                                           |
| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `BREVO_API_KEY` | Yes      | Brevo API v3 key (starts with xkeysib-) [Docs](https://developers.brevo.com/docs/getting-started#using-your-api-key-to-authenticate). |

## Setup

1. **Sign in to Brevo**: Go to [https://app.brevo.com](https://app.brevo.com) and sign in. The free plan is sufficient for testing (includes a daily transactional email allowance).
2. **Create an API key**: Open Settings → SMTP & API → API Keys ([https://app.brevo.com/settings/keys/api](https://app.brevo.com/settings/keys/api)) and generate a new v3 API key.
3. **Verify a sender**: Under Senders, Domains & Dedicated IPs, add and verify the sender address you will use in Send Email.
4. **Set the environment variable**: Add the key to your .env as BREVO\_API\_KEY=xkeysib-...
5. **Verify access**: Run List Lists to confirm the key works.

* Brevo authenticates with an 'api-key' header - not an Authorization Bearer token
* Get Contact accepts either an email address or the numeric contact ID in the path

Provider API reference: [https://developers.brevo.com/reference](https://developers.brevo.com/reference)

## Tools

| Tool                 | Access | Description                                          |
| -------------------- | ------ | ---------------------------------------------------- |
| Send Email           | Write  | Send a transactional email                           |
| List Contacts        | Read   | List contacts in the account                         |
| Get Contact          | Read   | Get a contact by email address or numeric ID         |
| Create Contact       | Write  | Create a new contact                                 |
| List Lists           | Read   | List contact lists                                   |
| List Email Campaigns | Read   | List email campaigns with status and scheduling info |

## Example prompts

* Send a transactional email via Brevo with a subject, recipient, and HTML body.
* Look up a Brevo contact by email address and show their attributes and lists.
