Create email sender | Brevo API Documentation

Creates a new email sender in your Brevo account.

Use this to:

Add new senders for email campaigns
Configure sender identity (name and email)
Associate dedicated IPs with the sender (for dedicated IP accounts)
Set up domain-based sender configurations

Key information returned:

Created sender ID
DKIM and SPF configuration status
Success confirmation

Important considerations:

Verification email sent to specified sender address
DKIM and SPF configuration affects deliverability
Dedicated IP accounts require IP association during creation
IP weights must sum to 100 when specified
Sender must be verified before use in campaigns

Creates a new email sender in your Brevo account. **Use this to:** - Add new senders for email campaigns - Configure sender identity (name and email) - Associate dedicated IPs with the sender (for dedicated IP accounts) - Set up domain-based sender configurations **Key information returned:** - Created sender ID - DKIM and SPF configuration status - Success confirmation **Important considerations:** - Verification email sent to specified sender address - DKIM and SPF configuration affects deliverability - Dedicated IP accounts require IP association during creation - IP weights must sum to 100 when specified - Sender must be verified before use in campaigns

Authentication

api-keystring

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

Request

sender's configuration

emailstringRequiredformat: "email"

From email to use for the sender. A verification email will be sent to this address.

namestringRequired

From Name to use for the sender

ipslist of objectsOptional

Mandatory in case of dedicated IP. IPs to associate to the sender. Not required for standard accounts.

Response

Sender created successfully

idlong

ID of the Sender created

dkimErrorboolean

Status of DKIM configuration for the sender (true = DKIM not well configured, false = DKIM well configured)

spfErrorboolean

Status of SPF configuration for the sender (true = SPF not well configured, false = SPF well configured)

Errors

400

Bad Request Error

1	import { BrevoClient } from "@getbrevo/brevo";
2
3	async function main() {
4	const client = new BrevoClient({
5	apiKey: "YOUR_API_KEY_HERE",
6	});
7	await client.senders.createSender({
8	email: "support@example.com",
9	name: "Support Team",
10	});
11	}
12	main();