Node.js SDK

UNOSEND_API_KEY=un_your_api_key

import { Unosend } from '@unosend/node';

const unosend = new Unosend(process.env.UNOSEND_API_KEY!);

import { Unosend } from '@unosend/node';

// Initialize with your API key
const unosend = new Unosend('un_your_api_key');

// Send an email
async function sendWelcomeEmail(email: string, name: string) {
  const { data, error } = await unosend.emails.send({
    from: '[email protected]',
    to: email,  // Can be string or string[]
    subject: `Welcome, ${name}!`,
    html: `<h1>Hello ${name}</h1><p>Welcome to our platform!</p>`
  });

  if (error) {
    console.error('Failed to send:', error.message);
    return null;
  }

  console.log('Email sent:', data.id);
  return data;
}

import { Unosend } from '@unosend/node';
import { readFileSync } from 'fs';

const unosend = new Unosend(process.env.UNOSEND_API_KEY!);

// Send email with file attachment
const { data, error } = await unosend.emails.send({
  from: '[email protected]',
  to: ['[email protected]'],
  subject: 'Your Invoice',
  html: '<p>Please find your invoice attached.</p>',
  attachments: [
    {
      filename: 'invoice.pdf',
      content: readFileSync('./invoice.pdf').toString('base64'),
      contentType: 'application/pdf'
    }
  ]
});

import { Unosend } from '@unosend/node';

const unosend = new Unosend(process.env.UNOSEND_API_KEY!);

// Add a domain
const { data: domain } = await unosend.domains.create('yourdomain.com');
console.log('Domain added:', domain.id);
console.log('DNS Records to add:', domain.records);

// List all domains
const { data: domains } = await unosend.domains.list();
console.log('Your domains:', domains);

// Verify domain DNS
const { data: verified } = await unosend.domains.verify(domain.id);
console.log('Domain status:', verified.status);

// Delete a domain
await unosend.domains.delete(domain.id);

import { Unosend } from '@unosend/node';

const unosend = new Unosend(process.env.UNOSEND_API_KEY!);

// Create an audience
const { data: audience } = await unosend.audiences.create('Newsletter Subscribers');
console.log('Audience created:', audience.id);

// Add a contact to the audience
const { data: contact } = await unosend.contacts.create(audience.id, {
  email: '[email protected]',
  firstName: 'John',
  lastName: 'Doe'
});
console.log('Contact added:', contact.id);

// List all contacts in an audience
const { data: contacts } = await unosend.contacts.list(audience.id);
console.log('Subscribers:', contacts.length);

// List all audiences
const { data: audiences } = await unosend.audiences.list();
console.log('Your audiences:', audiences);

import { Unosend } from '@unosend/node';

// Default configuration
const unosend = new Unosend('un_your_api_key');

// Custom base URL (for self-hosted instances)
const customClient = new Unosend('un_your_api_key', {
  baseUrl: 'https://your-instance.com/api/v1'
});

import { Unosend } from '@unosend/node';

const unosend = new Unosend(process.env.UNOSEND_API_KEY!);

async function sendEmail() {
  const { data, error } = await unosend.emails.send({
    from: '[email protected]',
    to: ['[email protected]'],
    subject: 'Hello',
    html: '<p>Hello World</p>'
  });

  if (error) {
    // Handle based on status code
    switch (error.statusCode) {
      case 429:
        console.log('Rate limited, please retry later');
        break;
      case 401:
        console.log('Check your API key');
        break;
      case 400:
        console.log('Validation error:', error.message);
        break;
      default:
        console.log('Error:', error.message);
    }
    return;
  }

  console.log('Email sent:', data.id);
}

import type { 
  SendEmailOptions, 
  Email, 
  Domain, 
  Audience,
  Contact,
  Webhook 
} from '@unosend/node';

// All methods are fully typed
const sendOptions: SendEmailOptions = {
  from: '[email protected]',
  to: ['[email protected]'],
  subject: 'Hello',
  html: '<p>Hello World</p>'
};