For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
      • GETGet email senders
      • POSTCreate email sender
      • PUTUpdate a sender
      • DELDelete a sender
      • PUTValidate a sender using OTP
      • GETGet all the dedicated IPs for your account
      • GETGet all the dedicated IPs for a specific sender
  • Sales CRM
  • Conversations
  • Ecommerce
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
Accounts and SettingsSenders

Get email senders

GET
https://api.brevo.com/v3/senders
GET
/v3/senders
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4 const client = new BrevoClient({
5 apiKey: "YOUR_API_KEY_HERE",
6 });
7 await client.senders.getSenders({});
8}
9main();
1{
2 "senders": [
3 {
4 "active": true,
5 "email": "support@example.com",
6 "id": 1,
7 "ips": [],
8 "name": "Support Team"
9 },
10 {
11 "active": false,
12 "email": "hello@example.com",
13 "id": 3,
14 "ips": [],
15 "name": "Customer Service"
16 },
17 {
18 "active": false,
19 "email": "marketing@testcompany.com",
20 "id": 5,
21 "ips": [],
22 "name": "Marketing Team"
23 }
24 ]
25}
Retrieves a list of all email senders from your Brevo account with optional filtering. **Use this to:** - Get all available senders for email campaign setup - Find sender details including ID, name, and email address - Filter senders by IP address for dedicated IP users - Filter senders by domain for domain-specific configurations - Monitor sender configuration and status **Key information returned:** - Sender details (ID, name, email address) - Sender status and verification information - Associated IP addresses and domains (for dedicated IP accounts) - Sender configuration settings **Important considerations:** - Standard accounts show empty IP arrays, dedicated IP accounts show IP assignments - Filtering by IP only available for accounts with dedicated IPs - Domain filtering helps organize senders by business units or brands - Sender status indicates if sender is active and ready for campaign use - Email verification required before sender can be used in campaigns
Was this page helpful?
Previous

Create email sender

Next
Built with

Retrieves a list of all email senders from your Brevo account with optional filtering.

Use this to:

  • Get all available senders for email campaign setup
  • Find sender details including ID, name, and email address
  • Filter senders by IP address for dedicated IP users
  • Filter senders by domain for domain-specific configurations
  • Monitor sender configuration and status

Key information returned:

  • Sender details (ID, name, email address)
  • Sender status and verification information
  • Associated IP addresses and domains (for dedicated IP accounts)
  • Sender configuration settings

Important considerations:

  • Standard accounts show empty IP arrays, dedicated IP accounts show IP assignments
  • Filtering by IP only available for accounts with dedicated IPs
  • Domain filtering helps organize senders by business units or brands
  • Sender status indicates if sender is active and ready for campaign use
  • Email verification required before sender can be used in campaigns

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

ipstringOptional

Filter your senders for a specific ip. Available for dedicated IP usage only

domainstringOptional
Filter your senders for a specific domain

Response

List of senders retrieved successfully
senderslist of objects
List of the senders available in your account

Errors

400
Bad Request Error