Brevo

brevo Messages API

Send and manage chat messages as an agent or automated bot within conversations.

GitHub OpenAPI
Business capability
Customer Inquiry Management BC-430.10

Operations 4

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

POST /conversations/messages Send a chat message as an agent · Send a message as an agent #
Ask an LLM
“How do I reply to a website visitor in live chat from code?”
“Can I send a chat message under a specific agent's name?”
Tell an agent
Send {text} to visitor {visitorId}.
Reply to visitor {visitorId} with {text} as agent {agentId}.
GET /conversations/messages/{messageId} Get a chat message · Get a message #
Ask an LLM
“Who sent a particular chat message and when?”
“Can I retrieve one chat message by its ID?”
Tell an agent
Show chat message {messageId}.
Get the text and sender of message {messageId}.
PUT /conversations/messages/{messageId} Edit an agent's chat message · Update a message #
Ask an LLM
“Can I fix a typo in a chat message I already sent?”
“Which chat messages are editable?”
Tell an agent
Change the text of message {messageId} to {text}.
Edit agent message {messageId} to read {text}.
DELETE /conversations/messages/{messageId} Delete a chat message · Delete a message #
Ask an LLM
“Can I remove a message from a chat conversation?”
“Is deleting a chat message permanent?”
Tell an agent destructive · confirm first
Delete chat message {messageId}.
Permanently remove message {messageId} from the conversation.

Documentation

📖
Documentation
https://developers.brevo.com/docs/send-a-transactional-email
📖
Documentation
https://developers.brevo.com/docs/getting-started
📖
Documentation
https://developers.brevo.com/docs/how-it-works
📖
Documentation
https://developers.brevo.com/docs/transactional-sms-endpoints
📖
Documentation
https://developers.brevo.com/docs/whatsapp-messages
📖
Documentation
https://developers.brevo.com/docs/import-your-products
📖
Documentation
https://developers.brevo.com/docs/transactional-webhooks

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/openapi/brevo-messages-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/asyncapi/brevo-webhooks-asyncapi.yml

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-messages-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.

GitHub Google LinkedIn

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

OpenAPI Specification

brevo-messages-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Brevo Conversations Messages API
  description: The Brevo Conversations API provides programmatic access to live chat and messaging features for customer support and engagement. It enables developers to manage chat conversations, send and receive messages, and integrate Brevo's chat widget into websites and applications. The API supports real-time communication with site visitors and can be used to build custom chat interfaces, automate responses, and route conversations to appropriate team members.
  version: '3.0'
  contact:
    name: Brevo Support
    url: https://help.brevo.com
  termsOfService: https://www.brevo.com/legal/termsofuse/
servers:
- url: https://api.brevo.com/v3
  description: Brevo Production API Server
security:
- apiKeyAuth: []
tags:
- name: Messages
  description: Send and manage chat messages as an agent or automated bot within conversations.
paths:
  /conversations/messages:
    post:
      operationId: sendMessageAsAgent
      summary: Send a message as an agent
      description: Sends a chat message within a conversation as an agent. The message is delivered to the visitor in real time through the Brevo chat widget.
      tags:
      - Messages
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessage'
      responses:
        '200':
          description: Message sent successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /conversations/messages/{messageId}:
    get:
      operationId: getMessage
      summary: Get a message
      description: Retrieves the details of a specific chat message by its unique identifier including the message text, sender, and timestamp.
      tags:
      - Messages
      parameters:
      - $ref: '#/components/parameters/messageIdParam'
      responses:
        '200':
          description: Message retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Message not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      operationId: updateMessage
      summary: Update a message
      description: Updates the text content of an existing chat message. Only agent messages can be updated.
      tags:
      - Messages
      parameters:
      - $ref: '#/components/parameters/messageIdParam'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                  description: Updated message text content.
      responses:
        '200':
          description: Message updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Message not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      operationId: deleteMessage
      summary: Delete a message
      description: Permanently deletes a chat message from a conversation.
      tags:
      - Messages
      parameters:
      - $ref: '#/components/parameters/messageIdParam'
      responses:
        '204':
          description: Message deleted successfully
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Message not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: Error code identifying the type of error.
        message:
          type: string
          description: Human-readable description of the error.
    MessageResponse:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the message.
        type:
          type: string
          description: Type of the message sender.
          enum:
          - agent
          - visitor
          - bot
        text:
          type: string
          description: Text content of the message.
        visitorId:
          type: string
          description: Unique identifier of the visitor.
        agentId:
          type: string
          description: Unique identifier of the agent if applicable.
        agentName:
          type: string
          description: Display name of the agent if applicable.
        createdAt:
          type: string
          format: date-time
          description: UTC date-time when the message was created.
    SendMessage:
      type: object
      required:
      - visitorId
      - text
      properties:
        visitorId:
          type: string
          description: Unique identifier of the visitor to send the message to.
        text:
          type: string
          description: Text content of the message.
        agentId:
          type: string
          description: Unique identifier of the agent sending the message.
        agentName:
          type: string
          description: Display name of the agent.
  parameters:
    messageIdParam:
      name: messageId
      in: path
      required: true
      description: Unique identifier of the chat message.
      schema:
        type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Brevo API key passed in the api-key request header for authentication.
externalDocs:
  description: Brevo Conversations Documentation
  url: https://developers.brevo.com/docs/getting-started-with-conversations-api