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

# Brevo

> Let UnleashX manage your Brevo contacts, companies and deals, and send transactional email and SMS.

# Brevo

> **In one line:** Connect Brevo so UnleashX can manage contacts, companies and deals, track events, and send transactional emails and SMS straight from a conversation or automation.

|                    |                                                                                                                                         |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Category**       | Marketing                                                                                                                               |
| **Authentication** | API Key                                                                                                                                 |
| **Setup time**     | \~3 minutes                                                                                                                             |
| **Difficulty**     | Easy                                                                                                                                    |
| **Best for**       | Teams using Brevo for email/SMS marketing and a lightweight CRM who want their agent to update records and send messages automatically. |

## 1. Overview

Brevo (formerly Sendinblue) is an all-in-one marketing and CRM platform for managing contacts, running email and SMS campaigns, and tracking a simple sales pipeline of companies and deals.

Once connected to UnleashX, your agent can add or update a contact after a call, attach them to a company, open or progress a deal, fire a tracking event, or send a transactional email or SMS — all without anyone touching the Brevo dashboard.

Connecting Brevo to UnleashX turns conversations into clean CRM data and instant follow-up messages, so leads get captured and contacted while they're still warm.

## 2. What you'll need

* A Brevo account (the free plan includes API access).
* A **verified sender** if you plan to send transactional email.
* Permission to create an **API key** (account owner or a user with API access).

<Note>
  No admin access? Ask your Brevo account owner to generate an API key and share it with you. The key is all UnleashX needs.
</Note>

## 3. Get your credentials

UnleashX authenticates to Brevo with an **API key**.

<Steps>
  <Step title="Open API keys">
    In Brevo, click your account name (top-right) → **SMTP & API**, then the **API Keys** tab: `https://app.brevo.com/settings/keys/api`
  </Step>

  <Step title="Generate a new key">
    Click **Generate a new API key**, give it a name like "UnleashX", and confirm.
  </Step>

  <Step title="Copy the key">
    Copy the key immediately.

    <Warning>
      Brevo shows the full API key only once, at creation. If you lose it, you'll need to generate a new one.
    </Warning>
  </Step>

  <Step title="(For email) verify a sender">
    If you'll send email, go to **Senders, Domains & Dedicated IPs** and verify the sender address you'll use as the "from" email.
  </Step>
</Steps>

| Capability the key grants      | Why UnleashX needs it                                           |
| ------------------------------ | --------------------------------------------------------------- |
| Contacts (read/write)          | Create, update, list and find contacts; manage list membership. |
| Companies & Deals (read/write) | Create and update companies and deals and link them together.   |
| Events                         | Track custom events against a contact.                          |
| Transactional email (SMTP)     | Send transactional emails from a verified sender.               |
| Transactional SMS              | Send transactional SMS messages.                                |

<Info>
  A Brevo API key is account-wide — it isn't scoped per feature. Only share it with tools you trust.
</Info>

## 4. Connect on UnleashX

<Steps>
  <Step title="Open your agent">
    Sign in at `https://www.tryunleashx.com` and open the agent you want to connect.
  </Step>

  <Step title="Find Brevo">
    Go to **Data Connectors** and find **Brevo**.
  </Step>

  <Step title="Connect">
    Click **Connect** / **Add** / **Configure** and paste your Brevo API key.
  </Step>

  <Step title="Confirm">
    Save. The status will switch to a **Connected** badge.
  </Step>
</Steps>

### Use Brevo in a Workflow

Once connected, you can add **Brevo** to any automation from the **Workflows** builder. Its triggers and tools appear in the Apps panel, marked with an **MCP** badge.

<Steps>
  <Step title="Add a trigger or action node">
    Open **Workflows → New Workflow**. On the canvas, click **+ Add Trigger** (or the **+** below any node) to add a step.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/05-add-trigger.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=449a0c03b0c7b40e571ec02373a85259" alt="Add a trigger on the workflow canvas" width="1390" height="722" data-path="images/mcp/workflows/05-add-trigger.png" />
  </Step>

  <Step title="Pick Brevo from the Apps panel">
    In the **Paths** panel, open the **Apps** tab and select **Brevo**. Use the search box if you have many connectors.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/06-apps-list.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=bbb8bb6e668c4f8e1f6fd5e4955a45f0" alt="Choose your app from the Apps list" width="2446" height="1550" data-path="images/mcp/workflows/06-apps-list.png" />
  </Step>

  <Step title="Choose a trigger or tool">
    Pick the trigger or action you want. Configure its fields — required fields are marked with a red asterisk (\*).
  </Step>

  <Step title="Add or select your account">
    Under **Selected account**, choose an already-connected account, or click **Add Account** to connect one now.
  </Step>

  <Step title="Save and test">
    Fill in the remaining fields and click **Save**. Use **Test** to verify the step, then toggle **Publish** when the workflow is ready.
  </Step>
</Steps>

<Note>
  The steps are the same for every connector. For the full workflow builder guide, see [Using MCP in Workflows](/mcp/workflows).
</Note>

## 5. Available tools

| Tool                | What it does                                                        | Changes data? |
| ------------------- | ------------------------------------------------------------------- | ------------- |
| Create Contact      | Create a new contact.                                               | ✏️ Yes        |
| Update Contact      | Update a contact by email or ID.                                    | ✏️ Yes        |
| Find Contact        | Get a single contact by email or ID.                                | No            |
| List Contacts       | List contacts.                                                      | No            |
| List Companies      | List companies.                                                     | No            |
| List Attributes     | List available contact attribute fields.                            | No            |
| Unsubscribe Contact | Remove contacts from a list.                                        | ⚠️ Yes        |
| Add Company         | Create a new company.                                               | ✏️ Yes        |
| Update Company      | Update an existing company.                                         | ✏️ Yes        |
| Find Company        | Get a single company by ID.                                         | No            |
| Delete Company      | Permanently delete a company.                                       | ⚠️ Yes        |
| Add Deal            | Create a new deal (optionally link contacts/companies, add a task). | ✏️ Yes        |
| Update Deal         | Update an existing deal.                                            | ✏️ Yes        |
| Find Deal           | Get a single deal by ID.                                            | No            |
| Delete Deal         | Permanently delete a deal.                                          | ⚠️ Yes        |
| Add Associations    | Link two CRM records (e.g. contact ↔ deal).                         | ✏️ Yes        |
| Remove Associations | Unlink two CRM records.                                             | ⚠️ Yes        |
| Create Event        | Track a custom event against a contact.                             | ✏️ Yes        |
| Send Email          | Send a transactional email.                                         | ✏️ Yes        |
| Send SMS            | Send a transactional SMS.                                           | ✏️ Yes        |

## 6. Example usage

**"Add [raj@acme.com](mailto:raj@acme.com) as a contact, then send him a welcome email from [hello@mycompany.com](mailto:hello@mycompany.com)."**
Runs **Create Contact**, then **Send Email**.

**"Create a deal called 'Acme renewal' worth 50000 INR and link it to contact [raj@acme.com](mailto:raj@acme.com)."**
Runs **Add Deal** with the amount and `contact_search` set to the email so it links the contact automatically.

## 7. Permissions & data access

**UnleashX can:**

* Create, read, update and delete contacts, companies and deals.
* Manage list membership and CRM associations.
* Send transactional email and SMS, and track events.

**UnleashX cannot:**

* Access Brevo data the API key's account can't access.
* Send email from an unverified sender address.
* Change your Brevo billing or account settings.

**To disconnect:** In UnleashX go to **Data Connectors → Brevo → Disconnect**. To fully revoke, delete the API key in **Brevo → SMTP & API → API Keys**. Revocation is immediate.

## 8. Troubleshooting

| Problem                             | What it means                                                  | How to fix it                                          |
| ----------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------ |
| `401 Unauthorized`                  | The API key is missing, wrong or deleted.                      | Reconnect in UnleashX with a valid key.                |
| `403 Forbidden`                     | Your plan or account doesn't allow that action.                | Check your Brevo plan/permissions, then retry.         |
| Email rejected / sender error       | The "from" address isn't a verified sender.                    | Verify the sender in Brevo and use that exact address. |
| `400 Bad Request` on a deal/company | A referenced contact, company or pipeline/stage ID is invalid. | Look up the correct ID first, then retry.              |
| `429 Too Many Requests`             | You hit Brevo's rate limit.                                    | Wait a moment and retry.                               |

For general connector issues, see [/mcp/integrations](/mcp/integrations).

## 9. Frequently asked questions

**Is my Brevo data stored by UnleashX?**
No. Tools call the Brevo API live and return the result. UnleashX doesn't keep a copy of your contacts or campaigns.

**Can I send marketing campaigns through this?**
These tools cover transactional email/SMS and CRM records, not bulk campaign creation. Build campaigns in Brevo; use UnleashX for per-contact actions and messages.

**How do I rotate my key?**
Generate a new key in Brevo, reconnect in UnleashX, then delete the old key.

## 10. References

* Brevo API getting started: [https://developers.brevo.com/docs/getting-started](https://developers.brevo.com/docs/getting-started)
* API keys page: [https://app.brevo.com/settings/keys/api](https://app.brevo.com/settings/keys/api)
* Senders & verification: [https://help.brevo.com/hc/en-us/articles/208836149](https://help.brevo.com/hc/en-us/articles/208836149)