⚠️ Important Notice: This is the current stable version but we are currently working on rebuilding our Node library from scratch.
Brevo's API exposes the entire Brevo features via a standardized programmatic interface. Please refer to the full documentation to see all the supported operations.
Brevo's API matches the OpenAPI v2 definition. The specification can be downloaded here.
Our current library is not fully compatible with all modern Node.js and TypeScript environments. To help you integrate Brevo into your applications, we're providing both plain Node.js and TypeScript-specific implementation approaches below while we work on the next generation of our SDK.
npm i @getbrevo/brevo --saveimport { TransactionalEmailsApi, SendSmtpEmail } from "@getbrevo/brevo";let emailAPI = new TransactionalEmailsApi();
emailAPI.authentications.apiKey.apiKey = "xkeysib-xxxxxxxxxxxxxxxxxxxxx"let message = new SendSmtpEmail();
message.subject = "First email";
message.textContent = "Hello world!";
message.sender = { name: "John Doe", email: "[email protected]" };
message.to = [{ email: "[email protected]", name: "Jane Smith" }];emailAPI.sendTransacEmail(message)emailAPI.sendTransacEmail(message).then(res => {
console.log(JSON.stringify(res.body));
}).catch(err => {
console.error("Error sending email:", err.body);
});npm i @getbrevo/brevo --saveimport { CreateContact, ContactsApi } from "@getbrevo/brevo";let contactAPI = new ContactsApi();
contactAPI.authentications.apiKey.apiKey = "xkeysib-xxxxxx"let contact = new CreateContact();
contact.email = "[email protected]";
contact.attributes = {
FIRSTNAME: "Alice",
LASTNAME: "Johnson",
};contactAPI.createContact(contact).then(res => {
console.log(JSON.stringify(res.body));
}).catch(err => {
console.error("Error creating contact:", err.body);
});We recommend using the following TypeScript configuration for optimal compatibility:
{
"compilerOptions": {
"target": "es2020",
"module": "commonjs",
"outDir": "dist",
"rootDir": "src",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true
},
"include": ["src"]
}npm i @getbrevo/brevo --saveimport { TransactionalEmailsApi, SendSmtpEmail } from "@getbrevo/brevo";let emailAPI = new TransactionalEmailsApi();
(emailAPI as any).authentications.apiKey.apiKey = "xkeysib-xxxxxxxxxxxxxxxxxxxxx";let message = new SendSmtpEmail();
message.subject = "First email";
message.textContent = "Hello world!";
message.sender = { name: "Bob Wilson", email: "[email protected]" };
message.to = [{ email: "[email protected]", name: "Sarah Davis" }];emailAPI.sendTransacEmail(message)emailAPI
.sendTransacEmail(message)
.then((res) => {
console.log(JSON.stringify(res.body));
})
.catch((err) => {
console.error("Error sending email:", err.body);
});npm i @getbrevo/brevo --saveimport { CreateContact, ContactsApi } from "@getbrevo/brevo";let contactAPI = new ContactsApi();
(contactAPI as any).authentications.apiKey.apiKey = "xkeysib-xxxxxxxxx"let contact = new CreateContact();
contact.email = "[email protected]";
contact.attributes = {
FIRSTNAME: { value: "Michael" },
LASTNAME: { value: "Brown" },
};contactAPI.createContact(contact).then(res => {
console.log(JSON.stringify(res.body));
}).catch(err => {
console.error("Error creating contact:", err.body);
});For questions and support, please refer to our documentation or contact our support team.
This SDK is distributed under the MIT License.