TypeScript / Node.js SDK

npm install wazobiamail
# or
bun add wazobiamail
# or
pnpm add wazobiamail

import { WazobiaMail } from 'wazobiamail';

const client = new WazobiaMail({
  apiKey: process.env.WAZOBIA_API_KEY!,
  timeout: 15_000,
});

const receipt = await client.send({
  from: 'Acme <hello@mail.example.com>',
  to: 'customer@example.com',
  subject: 'Your order shipped',
  html: '<p>Your order is on its way.</p>',
  text: 'Your order is on its way.',
}, {
  idempotencyKey: 'order-1042-shipped',
});

console.log(receipt.data.result.trackingId);

await client.messages.send({
  to: 'billing@example.com',
  subject: 'Invoice #1042',
  html: '<p>Invoice attached.</p>',
  attachments: [
    { url: 'https://cdn.example.com/1042.pdf', fileName: 'invoice-1042.pdf' },
  ],
});

import { WazobiaRateLimitError } from 'wazobiamail';

try {
  await client.send(message);
} catch (error) {
  if (error instanceof WazobiaRateLimitError) {
    console.error('Retry after', error.retryAfter, 'seconds');
  }
  throw error;
}