Where is the full API documentation?

The reference and guides live at developers.brevo.com. The pages on this hub show the request or config for each task and link to the matching docs page.

Which languages do the code samples cover?

The code samples use the Brevo SDKs for Node.js, Python and PHP, and plain cURL requests for the REST API. Framework guides add setup steps for tools such as Laravel, Django and Firebase.

Should I use the SMTP relay or the API?

Use the SMTP relay when an app or mail server already speaks SMTP: the host is smtp-relay.brevo.com and you authenticate with an SMTP key. The relay is designed for transactional email. For batches of personalized messages, use the batch sending endpoints of the API.

The REST API and SDKs use an API key. The SMTP relay uses an SMTP key, not an API key. The MCP server uses an MCP token, created by turning on Create MCP server API key when you generate a new API key.

Can an AI agent use my Brevo account?

Yes, through the Brevo MCP server. An assistant such as Claude, Cursor or a coding agent reads and acts on your account through tools for campaigns, contacts, templates, CRM deals and transactional email. Start with read-only prompts and review every draft in Brevo before it goes out.

DEVELOPERS

Build email, SMS and AI agent workflows on Brevo

Use the REST API, the SDKs for Node.js, Python and PHP, the SMTP relay or the MCP server. Pick a capability, follow a framework guide, or copy a prompt for your AI assistant.

Read the docs

Transactional messaging illustration: email, SMS and WhatsApp messages sent in a flow

Join 600,000+ customers around the world who trust Brevo

Why developers build on Brevo

One API, many channels

Email, SMS, WhatsApp, push notifications, CRM and loyalty each have a documented API capability.

SDKs for your stack

Send your first message with the Brevo SDK for Node.js, Python or PHP, or call the REST API with cURL.

Keep your mail server

Point an app or mail server at smtp-relay.brevo.com and keep sending transactional email over SMTP.

Ready for AI agents

The Brevo MCP server lets assistants such as Claude, Cursor and VS Code read and act on your account.

Send your first email

POSTapi.brevo.com/v3/smtp/email

curl --request POST \
--url https://api.brevo.com/v3/smtp/email \
--header 'accept: application/json' \
--header 'api-key:YOUR_API_KEY' \
--header 'content-type: application/json' \
--data '{
"sender":{
"name":"Alex from Brevo",
"email":"[email protected]"
},
"to":[
{
  "email":"[email protected]",
  "name":"John Doe"
}
],
"subject":"Hello from Brevo!",
"htmlContent":"<html><head></head><body><p>Hello,</p><p>This is my first transactional email sent from Brevo.</p></body></html>"
}'

import { BrevoClient } from '@getbrevo/brevo';

const brevo = new BrevoClient({ apiKey: 'your-api-key' });

const result = await brevo.transactionalEmails.sendTransacEmail({
  subject: 'Hello from Brevo!',
  htmlContent: '<html><body><p>Hello,</p><p>This is my first transactional email.</p></body></html>',
  sender: { name: 'Alex from Brevo', email: '[email protected]' },
  to: [{ email: '[email protected]', name: 'John Doe' }],
});

console.log('Email sent. Message ID:', result.messageId);

from brevo import Brevo
from brevo.transactional_emails import (
    SendTransacEmailRequestSender,
    SendTransacEmailRequestToItem,
)

client = Brevo(api_key="your-api-key")

result = client.transactional_emails.send_transac_email(
    subject="Hello from Brevo!",
    html_content="<html><body><p>Hello,</p><p>This is my first transactional email.</p></body></html>",
    sender=SendTransacEmailRequestSender(
        name="Alex from Brevo",
        email="[email protected]",
    ),
    to=[
        SendTransacEmailRequestToItem(
            email="[email protected]",
            name="John Doe",
        )
    ],
)

print("Email sent. Message ID:", result.message_id)

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Brevo\Brevo;
use Brevo\TransactionalEmails\Requests\SendTransacEmailRequest;
use Brevo\TransactionalEmails\Types\SendTransacEmailRequestSender;
use Brevo\TransactionalEmails\Types\SendTransacEmailRequestToItem;

$client = new Brevo(apiKey: 'your-api-key');

$result = $client->transactionalEmails->sendTransacEmail(
    new SendTransacEmailRequest([
        'subject' => 'Hello from Brevo!',
        'htmlContent' => '<html><body><p>Hello,</p><p>This is my first transactional email.</p></body></html>',
        'sender' => new SendTransacEmailRequestSender([
            'name' => 'Alex from Brevo',
            'email' => '[email protected]',
        ]),
        'to' => [
            new SendTransacEmailRequestToItem([
                'email' => '[email protected]',
                'name' => 'John Doe',
            ]),
        ],
    ])
);

echo 'Email sent. Message ID: ' . $result->messageId . PHP_EOL;

Send a transactional email from my verified sender to
me@example.com with the subject "Your order is confirmed", then
show me the message ID and its status in the logs.

Brevo MCP tools: transac_templates_send_transac_email,
transac_templates_get_transac_emails_list

Samples are taken from the Brevo developer docs and were not executed on this page. Replace the placeholder key and addresses with your own.

Find your starting point

Browse API capabilities, framework guides, AI agent resources and migration paths. Each page shows the request or config you need, with a link to the full docs.

API capabilities

Guides by framework

Node.js

Send email from Node.js with the Brevo SDK.

Read the Node.js guide

Laravel

Send email from Laravel with the Brevo API.

Read the Laravel guide

Django

Send email from Django through the Brevo SMTP relay.

Read the Django guide

Firebase

Send email from Firebase with the Brevo API.

Read the Firebase guide

Python and SMS

Send SMS from a Python application with the Brevo API.

Read the Python SMS guide

WordPress SMTP

Set up WordPress to send email through the Brevo relay.

Read the WordPress guide

Brevo MCP Server

Connect your AI tools directly to Brevo

Brevo's MCP Server lets your existing AI assistants talk directly to Brevo. This gives them the context they need to answer questions, run reports, and manage campaigns—all right inside your favourite AI tool.