Everything you need
to send and receive email

import { Nuntly } from '@nuntly/sdk';

const nuntly = new Nuntly('ny_your_api_key');

// Single email
await nuntly.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Your order is confirmed',
  html: '<p>Order #1234 has been confirmed.</p>',
});

// Bulk emails
await nuntly.emails.sendBulk([
  { from: 'hello@yourdomain.com', to: 'user1@example.com', subject: 'Welcome', html: '<p>Hi Alice</p>' },
  { from: 'hello@yourdomain.com', to: 'user2@example.com', subject: 'Welcome', html: '<p>Hi Bob</p>' },
]);

await nuntly.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Your trial is ending soon',
  html: '<p>Your trial expires tomorrow.</p>',
  scheduledAt: '2026-04-01T09:00:00Z',
});

import { Nuntly } from '@nuntly/sdk';

const nuntly = new Nuntly('ny_your_api_key');

// Create an inbox
const inbox = await nuntly.inboxes.create({
  address: 'support',
  name: 'Support Team',
});

// List messages in a thread
const messages = await nuntly.threads.messages.list('thread_01...');

import { Nuntly } from '@nuntly/sdk';

const nuntly = new Nuntly('ny_your_api_key');

const { data } = await nuntly.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome aboard',
  html: '<p>Thanks for signing up.</p>',
});

// Webhook payload example
{
  "type": "email.delivered",
  "timestamp": "2026-01-15T10:30:00Z",
  "data": {
    "emailId": "em_abc123",
    "to": "user@example.com",
    "subject": "Welcome aboard",
    "deliveredAt": "2026-01-15T10:30:00Z"
  }
}

import { Nuntly } from '@nuntly/sdk';

const nuntly = new Nuntly('ny_your_api_key');

// Full type safety and auto-completion
const { data } = await nuntly.emails.send({
  from: 'hello@yourdomain.com',
  to: ['user@example.com'],
  subject: 'Your order is confirmed',
  html: '<p>Order #1234 has been confirmed.</p>',
});

console.log(data.id); // Typed as string

Nuntly nuntly = new Nuntly("ny_your_api_key");

SendEmailResponse response = nuntly.emails().send(
  SendEmailRequest.builder()
    .from("hello@yourdomain.com")
    .to("user@example.com")
    .subject("Your order is confirmed")
    .html("<p>Order #1234 has been confirmed.</p>")
    .build()
);

System.out.println(response.getId());