Python SDK

1
from brevo import Brevo
2
3
client = Brevo(api_key="your-api-key")
4
5
result = client.transactional_emails.send_transac_email(
6
    subject="Hello",
7
    text_content="Hello world!",
8
    sender={"name": "Sender", "email": "sender@brevo.com"},
9
    to=[{"email": "recipient@example.com"}],
10
)
11
12
print("Email sent:", result)

1
from brevo import Brevo
2
3
client = Brevo(
4
    api_key="your-api-key",
5
    timeout=30.0,              # 30 seconds
6
    follow_redirects=True,     # Default: True
7
)

1
import asyncio
2
from brevo import AsyncBrevo
3
4
client = AsyncBrevo(api_key="your-api-key")
5
6
async def main() -> None:
7
    result = await client.transactional_emails.send_transac_email(
8
        subject="Hello",
9
        text_content="Hello world!",
10
        sender={"name": "Sender", "email": "sender@brevo.com"},
11
        to=[{"email": "recipient@example.com"}],
12
    )
13
    print("Email sent:", result)
14
15
asyncio.run(main())

1
from brevo import Brevo
2
from brevo.errors import (
3
    ApiError,
4
    UnauthorizedError,
5
    TooManyRequestsError,
6
)
7
8
client = Brevo(api_key="your-api-key")
9
10
try:
11
    client.transactional_emails.send_transac_email(
12
        subject="Hello",
13
        text_content="Hello world!",
14
        sender={"name": "Sender", "email": "sender@brevo.com"},
15
        to=[{"email": "recipient@example.com"}],
16
    )
17
except UnauthorizedError as e:
18
    print("Invalid API key")
19
except TooManyRequestsError as e:
20
    print(f"Rate limited: {e.body}")
21
except ApiError as e:
22
    print(f"API Error {e.status_code}: {e.body}")

1
from brevo import Brevo
2
3
client = Brevo(api_key="your-api-key")
4
5
# Request-level configuration
6
client.transactional_emails.send_transac_email(
7
    subject="Hello",
8
    text_content="Hello world!",
9
    sender={"name": "Sender", "email": "sender@brevo.com"},
10
    to=[{"email": "recipient@example.com"}],
11
    request_options={"max_retries": 5},
12
)

1
from brevo import Brevo
2
3
# Client-level timeout
4
client = Brevo(
5
    api_key="your-api-key",
6
    timeout=30.0,
7
)
8
9
# Request-level timeout
10
client.transactional_emails.send_transac_email(
11
    subject="Hello",
12
    text_content="Hello world!",
13
    sender={"name": "Sender", "email": "sender@brevo.com"},
14
    to=[{"email": "recipient@example.com"}],
15
    request_options={"timeout_in_seconds": 10},
16
)

1
client.transactional_emails.send_transac_email(
2
    subject="Hello",
3
    text_content="Hello world!",
4
    sender={"name": "Sender", "email": "sender@brevo.com"},
5
    to=[{"email": "recipient@example.com"}],
6
    request_options={
7
        "additional_headers": {"X-Custom-Header": "custom-value"}
8
    },
9
)

1
client.transactional_emails.send_transac_email(
2
    subject="Hello",
3
    text_content="Hello world!",
4
    sender={"name": "Sender", "email": "sender@brevo.com"},
5
    to=[{"email": "recipient@example.com"}],
6
    request_options={
7
        "additional_query_parameters": {"custom_param": "value"}
8
    },
9
)

1
from brevo import Brevo
2
3
client = Brevo(api_key="your-api-key")
4
5
response = client.transactional_emails.with_raw_response.send_transac_email(
6
    subject="Hello",
7
    text_content="Hello world!",
8
    sender={"name": "Sender", "email": "sender@brevo.com"},
9
    to=[{"email": "recipient@example.com"}],
10
)
11
12
print(response.status_code)
13
print(response.headers)
14
print(response.data)

1
from brevo import Brevo
2
3
client = Brevo(api_key="your-api-key")
4
5
client.transactional_emails.send_transac_email(
6
    subject="First email",
7
    text_content="Hello world!",
8
    sender={"name": "Bob Wilson", "email": "bob.wilson@brevo.com"},
9
    to=[{"email": "sarah.davis@example.com", "name": "Sarah Davis"}],
10
)

1
from brevo import Brevo
2
3
client = Brevo(
4
    api_key="your-api-key",
5
    logging={
6
        "level": "debug",
7
        "silent": False,
8
    },
9
)

1
import logging
2
from brevo import Brevo
3
4
logger = logging.getLogger("brevo")
5
logger.setLevel(logging.DEBUG)
6
handler = logging.StreamHandler()
7
handler.setFormatter(logging.Formatter("%(asctime)s - %(name)s - %(message)s"))
8
logger.addHandler(handler)
9
10
client = Brevo(
11
    api_key="your-api-key",
12
    logging={
13
        "level": "debug",
14
        "logger": logger,
15
    },
16
)

1
import httpx
2
from brevo import Brevo
3
4
client = Brevo(
5
    api_key="your-api-key",
6
    httpx_client=httpx.Client(
7
        proxy="http://my.test.proxy.example.com",
8
        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
9
    ),
10
)