# Brevo

> Automate Brevo: manage contacts, lists, and email campaigns.

App · Email Marketing · 8 actions. Web page: https://docs.lodol.com/docs/integrations/brevo

## Actions

### Add contact to list

Add a contact to a Brevo list by email.

**Inputs**

- List ID (`list_id`, text, required): The ID of the Brevo list.
- Email (`email`, text, required): Contact email

**Outputs**

- `contacts` (object)

**Example output**

```json
{
  "contacts": {
    "failure": [],
    "success": [
      "contact@example.com"
    ]
  }
}
```

### Create contact

Create a Brevo contact and optionally add it to lists.

**Inputs**

- Email (`email`, text, required): Contact email
- Attributes (`attributes`, object): The contact's details to save, such as first name, last name, or phone number.
- List IDS (`list_ids`, list): IDs of the lists to add the contact to.
- Update existing (`update_existing`, true/false): Set to true to update the contact if one with this email already exists. Default: `false`.

**Outputs**

- `id` (number)

**Example output**

```json
{
  "id": 42
}
```

### Create contact list

Create a new Brevo contact list.

**Inputs**

- Name (`name`, text, required): List name
- Folder ID (`folder_id`, number, required): ID of the folder to create the list in. Brevo requires every list to live in a folder. New accounts have a default folder with ID 1.

**Outputs**

- `id` (number)

**Example output**

```json
{
  "id": 42
}
```

### Create email campaign

Create an email campaign targeting specific lists.

**Inputs**

- Sender name (`sender_name`, text, required): Sender name
- Sender email (`sender_email`, text, required): Sender email
- Subject (`subject`, text, required): Campaign subject
- Email body (`html_content`, text, required): The content of the email. You can use HTML formatting, such as <b>bold</b> text and links.
- List IDS (`list_ids`, list, required): IDs of the contact lists that will receive the campaign.

**Outputs**

- `id` (number)

**Example output**

```json
{
  "id": 42
}
```

### Get contact

Fetch a contact by email.

**Inputs**

- Email (`email`, text, required): Contact email

**Outputs**

- `attributes` (object)
- `createdAt` (text)
- `email` (text)
- `emailBlacklisted` (true/false)
- `id` (number)
- `listIds` (list)
- `listUnsubscribed` (list)
- `modifiedAt` (text)
- `smsBlacklisted` (true/false)
- `statistics` (object)
- `whatsappBlacklisted` (true/false)

**Example output**

```json
{
  "attributes": {
    "FIRSTNAME": "Ada",
    "LASTNAME": "Lovelace"
  },
  "createdAt": "2026-07-26T12:00:00.000+00:00",
  "email": "contact@example.com",
  "emailBlacklisted": false,
  "id": 42,
  "listIds": [
    1
  ],
  "listUnsubscribed": [],
  "modifiedAt": "2026-07-26T12:00:00.000+00:00",
  "smsBlacklisted": false,
  "statistics": {
    "clicked": [],
    "complaints": [],
    "delivered": [],
    "hardBounces": [],
    "messagesSent": [],
    "opened": [],
    "softBounces": [],
    "unsubscriptions": {
      "adminUnsubscription": [],
      "userUnsubscription": []
    }
  },
  "whatsappBlacklisted": false
}
```

### List contacts

List contacts from your Brevo account, one page at a time.

**Inputs**

- Limit (`limit`, number): Maximum results
- Offset (`offset`, number): The number of contacts to skip before starting the list. Use this to see later pages of results.

**Outputs**

- `results` (list)

**Example output**

```json
{
  "results": [
    {}
  ]
}
```

### Send transactional email

Send a single transactional email, such as an order confirmation or receipt, with a subject and message body.

**Inputs**

- Sender email (`sender_email`, text, required): Sender email
- To email (`to_email`, text, required): Recipient email
- Subject (`subject`, text, required): Email subject
- Email body (`html_content`, text, required): The content of the email. You can use HTML formatting, such as <b>bold</b> text and links.
- Sender name (`sender_name`, text): Sender name

**Outputs**

- `messageId` (text)

**Example output**

```json
{
  "messageId": "<202607261200.44445555666@smtp-relay.brevo.com>"
}
```

### Update contact

Update a contact's details and which lists they belong to.

**Inputs**

- Email (`email`, text, required): Contact email
- Attributes (`attributes`, object): The contact details to change, such as first name or last name.
- Add to lists (`list_ids`, list): IDs of the lists to add the contact to.
- Remove from lists (`unlink_list_ids`, list): IDs of the lists to remove the contact from.

**Outputs**

- `status_code` (number)

**Example output**

```json
{
  "status_code": 204
}
```
