Quickstart

Get Started in 5 Minutes

This guide will walk you through creating your first inbox, sending an email, receiving emails via webhooks, and optional custom domain setup.

Go to sendook.com and create an account
Navigate to your dashboard and generate an API key
Copy your API key - you’ll need it for authentication

Keep your API key secure! Never commit it to version control or expose it in client-side code.

Install the SDK (Optional)

You can use Sendook via direct API calls or the TypeScript SDK:

npm install @sendook/node

Create Your First Inbox

Create an inbox to send and receive emails. You can use a @sendook.com address (no verification needed) or your own custom domain.

TypeScript SDK
cURL
Custom Domain

import Sendook from "@sendook/node";

// Initialize client with your API key
const client = new Sendook("your_api_key");

// Create an inbox with a @sendook.com address
const inbox = await client.inbox.create({
  name: "support",
  email: "[email protected]"
});

console.log(`Inbox created: ${inbox.email}`);
console.log(`Inbox ID: ${inbox.id}`);

curl -X POST https://api.sendook.com/v1/inboxes \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "support",
    "email": "[email protected]"
  }'

import Sendook from "@sendook/node";

const client = new Sendook("your_api_key");

// First, add your custom domain
const domain = await client.domain.create({
  name: "yourdomain.com"
});

// Get DNS records to configure
const dnsRecords = await client.domain.dns({
  domainId: domain.id
});

console.log("Add these DNS records:", dnsRecords);

// After adding DNS records, verify the domain
const verified = await client.domain.verify({
  domainId: domain.id
});

// Now create inbox with your custom domain
const inbox = await client.inbox.create({
  name: "support",
  email: "[email protected]"
});

Domain Verification:

@sendook.com emails work immediately
Custom domains require MX records (receiving) and DKIM/SPF/DMARC records (sending)

Send Your First Email

Now let’s send an email from your inbox:

TypeScript SDK
cURL
With CC, BCC & Labels

// Send an email
const message = await client.inbox.message.send({
  inboxId: inbox.id,
  to: ["[email protected]"],
  subject: "Welcome to Sendook!",
  text: "Thanks for trying Sendook.",
  html: "<p>Thanks for trying <strong>Sendook</strong>.</p>"
});

console.log(`Message sent: ${message.id}`);

curl -X POST https://api.sendook.com/v1/inboxes/{inbox_id}/messages/send \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Welcome to Sendook!",
    "text": "Thanks for trying Sendook.",
    "html": "<p>Thanks for trying <strong>Sendook</strong>.</p>"
  }'

const message = await client.inbox.message.send({
  inboxId: inbox.id,
  to: ["[email protected]"],
  cc: ["[email protected]"],
  bcc: ["[email protected]"],
  labels: ["welcome", "onboarding"],
  subject: "Welcome to Sendook!",
  text: "Thanks for trying Sendook.",
  html: "<p>Thanks for trying <strong>Sendook</strong>.</p>",
  attachments: [
    {
      content: "base64_encoded_content",
      name: "welcome.pdf",
      contentType: "application/pdf"
    }
  ]
});

Rate Limits: Each inbox can send up to 100 messages per hour. Need higher limits? Contact support.

Receive Emails with Webhooks

Set up a webhook to receive incoming emails in real-time:

TypeScript SDK
cURL
Webhook Handler

// Create a webhook to receive emails
const webhook = await client.webhook.create({
  url: "https://your-app.com/webhooks/email",
  events: ["message.received"]
});

console.log(`Webhook created: ${webhook.id}`);

curl -X POST https://api.sendook.com/v1/webhooks \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhooks/email",
    "events": ["message.received"]
  }'

// Example webhook handler (Express.js)
import express from "express";

const app = express();
app.use(express.json());

app.post("/webhooks/email", (req, res) => {
  const { event, payload } = req.body;
  
  if (event === "message.received") {
    const message = payload;
    console.log(`New email from: ${message.from}`);
    console.log(`Subject: ${message.subject}`);
    console.log(`Body: ${message.text}`);
    
    // Process the email...
  }
  
  res.sendStatus(200);
});

app.listen(3000);

Available webhook events:

message.received - Incoming email received
message.sent - Email sent successfully
message.delivered - Email delivered to recipient
message.bounced - Email bounced
message.rejected - Email rejected
inbox.created - New inbox created
inbox.deleted - Inbox deleted

Test your webhook using the test endpoint:

await client.webhook.test(webhook.id);

View Messages & Threads

Retrieve and search through your messages:

List Messages
Search Messages
Get Threads
Reply to Message

// Get all messages in an inbox
const messages = await client.inbox.message.list(inbox.id);

console.log(`Total messages: ${messages.length}`);

// Search messages with regex
const results = await client.inbox.message.list(
  inbox.id,
  "urgent" // Search query (supports regex)
);

console.log(`Found ${results.length} messages`);

// Get conversation threads
const threads = await client.inbox.thread.list(inbox.id);

// Get specific thread with all messages
const thread = await client.inbox.thread.get(
  inbox.id,
  thread.id
);

console.log(`Messages in thread: ${thread.messages.length}`);

// Reply to a message (automatically threads)
const reply = await client.inbox.message.reply({
  inboxId: inbox.id,
  messageId: message.id,
  text: "Thanks for your message!",
  html: "<p>Thanks for your message!</p>"
});

console.log(`Reply sent: ${reply.id}`);

What’s Next?

API Reference

Explore all available endpoints and methods

Webhooks Guide

Learn about webhook events and best practices

Custom Domains

Set up and verify your custom email domain

SDK Documentation

Deep dive into the TypeScript SDK

Common Use Cases

Customer Support Emails

Create a [email protected] inbox and use webhooks to automatically route incoming support emails to your ticketing system.

const inbox = await client.inbox.create({
  name: "support",
  email: "[email protected]"
});

const webhook = await client.webhook.create({
  url: "https://your-app.com/create-ticket",
  events: ["message.received"]
});

Transactional Emails

Send order confirmations, password resets, and notifications from your application.

await client.inbox.message.send({
  inboxId: inbox.id,
  to: [user.email],
  subject: "Order Confirmation #12345",
  html: orderConfirmationTemplate,
  labels: ["transactional", "order"]
});

AI Email Agents

Use Sendook with AI to automatically handle incoming emails, like at Rupt.

app.post("/webhooks/email", async (req, res) => {
  const { payload } = req.body;
  
  // Process with AI
  const response = await ai.processEmail(payload.text);
  
  // Send automated reply
  await client.inbox.message.reply({
    inboxId: payload.inboxId,
    messageId: payload.id,
    text: response,
    html: `<p>${response}</p>`
  });
  
  res.sendStatus(200);
});

Need Help?

Join our Community

Get help, share ideas, and connect with other Sendook users

Get Started

Core Features

Guides

Get Started in 5 Minutes

What’s Next?

API Reference

Webhooks Guide

Custom Domains

SDK Documentation

Common Use Cases

Need Help?

Join our Community

Build docs developers (and LLMs) love

Get Started

Core Features

Guides

​Get Started in 5 Minutes

​What’s Next?

API Reference

Webhooks Guide

Custom Domains

SDK Documentation

​Common Use Cases

​Need Help?

Join our Community

Build docs developers (and LLMs) love

Get Started in 5 Minutes

What’s Next?

Common Use Cases

Need Help?