brevo.com

•

API Key

About Brevo

Brevo (formerly Sendinblue) is a digital marketing and CRM platform used by SMBs and mid-market companies for email campaigns, transactional email, SMS, WhatsApp messaging, and marketing automation. Unlike most email platforms that charge per contact, Brevo prices by monthly email sending volume, making it cost-effective for large lists with infrequent sends. It offers a generous free tier, a drag-and-drop editor, multi-step automation workflows, A/B testing, and AI segmentation.

AI Agent Use Cases

- Email marketing with drag-and-drop editor and template library

- Transactional email via SMTP and REST API with unlimited log retention

- SMS and WhatsApp marketing across most paid tiers

- Multi-step marketing automation and A/B testing

- AI segmentation and AI data analyst features

- Built-in CRM and sales pipeline tools (Sales add-on)

Available Actions

These are the specific actions that AI agents can perform with this tool

Automation Endpoint Execution

1 input

Executes automation capabilities allowing programmatic operation of endpoints

Inputs

BaseURL

The base URL for the API requests

Conversation Finished

7 inputs

Triggered when a conversation is finished, either by the visitor going offline or all participating agents leaving.

Inputs

eventName

Indicates the type of event, for this endpoint it is 'conversationTranscript'.

conversationId

Unique ID of the continuous conversation with one visitor.

messages

List of messages exchanged during the conversation.

missedMessagesCount

Number of messages that were missed during the conversation.

agents

List of agents who participated in the conversation.

visitor

Information about the visitor involved in the conversation.

conversationStartPage

Information about the page where the conversation started, including link and title.

Conversation Initiated

7 inputs

Identifies and triggers an event when a conversation is initiated by a visitor or an agent.

Inputs

eventName

Name of the event, which is 'conversationStarted'.

conversationId

ID of the continuous conversation with one visitor.

message

Initial message object containing details like text, time created, agent information if applicable.

agent

Information about the agent if the chat was started by an agent.

visitor

Visitor information including country, language, browser, and other attributes.

conversationStartPage

Details of the website page including link and title when the conversation started.

isNoAvailableAgent

Indicates if no agent is online when the conversation started.

Create Contact List

2 inputs

Creates a new contact list in Brevo

Inputs

name

Name of the list

folderId

Id of the parent folder in which this list is to be created

Create Event

5 inputs

Creates an event to monitor a contact's interaction with Brevo platforms.

Inputs

event_name

The name of the event that occurred.

event_date

Timestamp of when the event occurred.

identifiers

Identifies the contact associated with the event.

contact_properties

Properties defining the state of the contact associated with this event.

event_properties

Properties of the event, including string, number, boolean, and date types.

Create List

2 inputs

Creates a new contact list in the specified folder.

Inputs

name

Name of the list

folderId

ID of the parent folder in which this list is to be created

Create New Event

5 inputs

Creates a new event in the Brevo system

Inputs

event_name

The name of the event that occurred. Limited to 255 characters, alphanumerical characters and - _ only.

event_date

Timestamp of when the event occurred. If no value is passed, the timestamp of the event creation is used.

identifiers

Identifies the contact associated with the event. At least one identifier is required.

contact_properties

Properties defining the state of the contact associated to this event. Used to update contact attributes.

event_properties

Properties of the event. Keys limited to 255 characters, alphanumerical characters and - _ only. Size is limited to 50Kb.

Create an Event

5 inputs

This endpoint creates an event to monitor a contact's interaction.

Inputs

eventName

The name of the event that occurred.

eventDate

Timestamp of when the event occurred. If not provided, uses the event creation timestamp.

identifiers

Identifies the contact associated with the event.

contactProperties

Properties defining the state of the contact associated to this event.

eventProperties

Properties of the event. Can include top level and nested properties.

Create and Send Email

4 inputs

Create and send a transactional email

Inputs

emailTo

The recipient's email address

emailFrom

The sender's email address

subject

The subject of the email

content

The content of the email

Delete Contact List

1 input

Deletes an existing contact list from an account using its ID

Inputs

listId

Id of the list to be deleted

Delete List

1 input

Delete a specific contact list by ID.

Inputs

listId

Id of the list to be deleted.

Delete List Endpoint

1 input

Deletes a contact list from the system

Inputs

listId

Id of the list to be deleted

Email Campaign History

9 inputs

Retrieve information about past email campaigns

Inputs

type

Filter on the type of the campaigns, e.g., classic or trigger

status

Filter on the status of the campaign, e.g., sent, draft

statistics

Type of statistics to be retrieved, e.g., globalStats

startDate

UTC start date-time to filter sent email campaigns, required if endDate is used

endDate

UTC end date-time to filter sent email campaigns, required if startDate is used

limit

Number of documents per page, defaults to 50

offset

Index of the first document in the page, defaults to 0

sort

Sort order, either asc or desc, defaults to desc

excludeHtmlContent

Exclude HTML content from the response

Email Campaigns Retriever

9 inputs

Fetches email campaigns with the option to filter based on type, status, date, and other parameters.

Inputs

Type

Filter on the type of the campaigns, e.g., classic or trigger.

Status

Filter based on campaign status, e.g., sent, draft, queued.

Statistics

Specify the type of statistics to fetch. Options include globalStats, linksStats, etc.

StartDate

Start date for filtering campaigns. Mandatory if endDate is used.

EndDate

End date for filtering campaigns. Mandatory if startDate is used.

Limit

Number of campaigns per page, ranging from 0 to 100. Defaults to 50.

Offset

Index of the first document on the page. Defaults to 0.

Sort

Sort order for the results, either asc or desc. Defaults to desc.

ExcludeHtmlContent

Flag to exclude HTML content from the response body. If true, the content will be an empty string.

Email History Retrieval

6 inputs

Retrieve a list of received email events within a specified date range.

Inputs

sender

Email address of the sender.

startDate

Starting date from which to fetch the list. Mandatory if endDate is used. Maximum time period that can be selected is one month.

endDate

Ending date till which to fetch the list. Mandatory if startDate is used. Maximum time period that can be selected is one month.

limit

Number of documents returned per page. Defaults to 100.

offset

Index of the first document on the page. Defaults to 0.

sort

Sort the results in ascending or descending order of record creation. Defaults to desc.

Find Emails

6 inputs

Retrieves a list of received email events with filtering options for sender, start and end dates, and more.

Inputs

Sender

Email address of the sender.

StartDate

Starting date from which you want to fetch the list. Mandatory if endDate is used. Maximum time period that can be selected is one month.

EndDate

Ending date till which you want to fetch the list. Mandatory if startDate is used. Maximum time period that can be selected is one month.

Limit

Number of documents returned per page.

Offset

Index of the first document on the page.

Sort

Sort the results in the ascending/descending order of record creation.

Get All Contact Lists

3 inputs

Retrieve and list all the contact lists from your account

Inputs

limit

Number of documents per page

offset

Index of the first document of the page

sort

Sort the results in the ascending/descending order of record creation

Get All Contacts

4 inputs

Get all contacts from the API

Inputs

limit

Number of documents per page

offset

Index of the first document of the page

modifiedSince

Filter the contacts modified after a given UTC date-time

sort

Sort the results in ascending/descending order of record creation

Get Contact List

8 inputs

Retrieve a list of contacts with optional filtering and sorting

Inputs

Limit

Number of documents per page

Offset

Index of the first document of the page

ModifiedSince

Filter contacts modified after this date-time

CreatedSince

Filter contacts created after this date-time

Sort

Sort order of records

SegmentId

Id of the segment; either listIds or segmentId can be used

ListIds

Ids of the list; either listIds or segmentId can be used

Filter

Filter contacts based on attributes with equals operator

Get Contact Lists

3 inputs

Fetch a list of all available contact lists in the account

Inputs

limit

Number of documents per page

offset

Index of the first document of the page

sort

Sort the results in ascending or descending order of record creation

Get Contacts

8 inputs

Fetches a list of contacts, with options to filter and sort the list.

Inputs

limit

Number of documents per page, defaults to 50, range 0 to 1000.

offset

Index of the first document of the page, defaults to 0.

modifiedSince

Filter contacts modified after a specified UTC date-time.

createdSince

Filter contacts created after a specified UTC date-time.

sort

Sort the order of records, defaults to descending.

segmentId

ID of the segment, either listIds or segmentId can be passed.

listIds

IDs of the list, either listIds or segmentId can be passed.

filter

Filter contacts by attributes using equals condition.

Get Events

2 inputs

Retrieves events data

Inputs

Limit

The number of results returned per page

Offset

The index of the first document in the page

Get List Items

1 input

Retrieves items from a specified list

Inputs

listId

The ID of the list from which items are to be retrieved

Get Lists

2 inputs

Retrieve all contact lists with optional limits and offsets for paging.

Inputs

Limit

Number of lists to retrieve per page.

Offset

Index of the first list to retrieve.

Import Contacts

6 inputs

Imports contacts with their details and adds them to a specified contact list.

Inputs

fileBody

The CSV data containing the contact details such as email, first name, and other fields.

listIds

The list IDs where the contacts should be imported.

emailBlacklist

If true, contacts will be added to email blacklist.

smsBlacklist

If true, contacts will be added to SMS blacklist.

updateExistingContacts

If true, existing contacts will be updated.

emptyContactsAttributes

If true, empty contact attributes will be updated.

RetrieveListItems

2 inputs

Retrieve a list of items using the specified settings.

Inputs

apiKey

API key for authenticating the request

settings

An object containing various settings like chatHeight, buttonStyle, etc.

Send SMS Message

8 inputs

Send a transactional SMS message to a mobile number.

Inputs

sender

Name of the sender.

recipient

Mobile number to send SMS with the country code.

content

Content of the message.

type

Type of the SMS.

tag

Tag of the message.

webUrl

Webhook to call for each event triggered by the message.

unicodeEnabled

Indicates whether the content should be treated as unicode or not.

organisationPrefix

A recognizable prefix added as Brand Name before the message content.

Send Transactional Email

7 inputs

Send a transactional email using the Brevo API.

Inputs

sender

The sender's details, including name and email.

List of recipient(s), each containing an email and name.

subject

The subject of the email.

htmlContent

The HTML content of the email.

templateId

ID of the email template to use.

params

Dynamic parameters to use in the email template.

headers

Custom headers to include with the email.

Update Contact List

3 inputs

Update a contact list with a new name or folder id

Inputs

listId

Id of the list

name

Name of the list. Either of the two parameters (name, folderId) can be updated at a time.

folderId

Id of the folder in which the list is to be moved. Either of the two parameters (name, folderId) can be updated at a time.

Update List

3 inputs

Update the details of a specific contact list

Inputs

listId

Id of the list

name

Name of the list. Either of the two parameters (name, folderId) can be updated at a time.

folderId

Id of the folder in which the list is to be moved. Either of the two parameters (name, folderId) can be updated at a time.