Brevo Conversations API

The conversations API from Brevo — 6 operation(s) for conversations.

Business capability
Customer Inquiry Management BC-430.10

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /conversations/messages/{id} Delete a message an agent sent · Delete a message sent by an agent #
Ask an LLM
“How do I delete a chat reply an agent posted by mistake?”
“Can visitor messages be deleted or only agent ones?”
Tell an agent destructive · confirm first
Delete agent message {id}.
Remove the agent's chat reply {id} from the conversation.
PUT /conversations/messages/{id} Edit a message an agent sent · Update a message sent by an agent #
Ask an LLM
“Can I fix a typo in a chat reply an agent already sent?”
“Which messages am I allowed to edit in a conversation?”
Tell an agent
Change the text of agent message {id} to {text}.
Edit the agent's chat reply {id} so it reads {text}.
GET /conversations/messages/{id} Get a conversation message · Get a message #
Ask an LLM
“What did a specific chat message in Brevo Conversations say?”
“Can I fetch one agent or visitor message by its ID?”
Tell an agent
Get conversation message {id}.
Show me the chat message with ID {id}.
POST /conversations/messages Reply to a visitor as an agent · Send a message as an agent #
Ask an LLM
“How do I post a chat reply to a website visitor as one of my agents?”
“Can I reply as an agent by email and name instead of agent ID?”
Tell an agent
Reply to visitor {visitorId} as agent {agentId} saying {text}.
Send {text} to visitor {visitorId} as agent {agentName} ({agentEmail}) from {receivedFrom}.
DELETE /conversations/pushedMessages/{id} Delete an automated chat message · Delete an automated message #
Ask an LLM
“How do I remove a pushed message from a visitor's chat?”
“Can I delete an automated message I sent by mistake?”
Tell an agent destructive · confirm first
Delete automated message {id}.
Remove pushed message {id} from the conversation.
PUT /conversations/pushedMessages/{id} Edit an automated chat message · Update an automated message #
Ask an LLM
“Can I change the text of an automated message after it was pushed?”
“How do I correct a pushed order-status message?”
Tell an agent
Update automated message {id} to say {text}.
Rewrite the pushed message {id} as {text}.
GET /conversations/pushedMessages/{id} Get an automated chat message · Get an automated message #
Ask an LLM
“What did an automated pushed message to a visitor contain?”
“Can I look up one proactive message by its ID?”
Tell an agent
Get automated message {id}.
Show the pushed chat message {id}.
POST /conversations/pushedMessages Push an automated message to a visitor · Send an automated message to a visitor #
Ask an LLM
“How do I push an order status update into a visitor's chat window?”
“Can I send a proactive message on behalf of an agent group?”
Tell an agent
Push automated message {text} to visitor {visitorId}.
Push {text} to visitor {visitorId} on behalf of agent group {groupId}.
POST /conversations/agentOnlinePing Keep an agent shown as online · Sets agent's status to online for 2-3 minutes #
Ask an LLM
“How do I keep an agent showing as online in the chat widget?”
“How often should I ping to keep an agent's status online?”
Tell an agent
Mark agent {agentId} online for the next few minutes.
Ping online status for agent {agentName} at {agentEmail}.
PUT /conversations/visitorGroup Assign a visitor to an agent group · Set visitor group assignment #
Ask an LLM
“How do I route a chat visitor to a specific team of agents?”
“Can I take a visitor out of their current agent group?”
Tell an agent
Assign the visitor to agent group {groupId}.
Move the visitor into group {groupId}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/brevo:brevo-conversations-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

brevo-conversations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Conversations API
  version: 1.0.0
servers:
- url: https://api.brevo.com/v3
  description: https://api.brevo.com/v3
tags:


# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/openapi/brevo-conversations-api-openapi.yml