Quickstart

Get started with Sendook in 5 minutes - create an inbox, send your first email, and set up webhooks

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.

1. Sign Up & Get API Key

   1. Go to sendook.com and create an account
   2. Navigate to your dashboard and generate an API key
   3. 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.

2. Install the SDK (Optional)

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

   npm

   npm install @sendook/node
   

   yarn add @sendook/node
   

   bun add @sendook/node
   
3. 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

   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: "[e-mail]"
   });
   
   console.log(`Inbox created: ${inbox.email}`);
   console.log(`Inbox ID: ${inbox.id}`);
   

   cURL

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

   Custom Domain

   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: "[e-mail]"
   });
   

   Domain Verification:

   • @sendook.com emails work immediately
   • Custom domains require MX records (receiving) and DKIM/SPF/DMARC records (sending)
4. Send Your First Email

   Now let’s send an email from your inbox:

   TypeScript SDK

   // Send an email
   const message = await client.inbox.message.send({
     inboxId: inbox.id,
     to: ["[e-mail]"],
     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

   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": ["[e-mail]"],
       "subject": "Welcome to Sendook!",
       "text": "Thanks for trying Sendook.",
       "html": "<p>Thanks for trying <strong>Sendook</strong>.</p>"
     }'
   

   With CC, BCC & Labels

   const message = await client.inbox.message.send({
     inboxId: inbox.id,
     to: ["[e-mail]"],
     cc: ["[e-mail]"],
     bcc: ["[e-mail]"],
     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.

5. Receive Emails with Webhooks

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

   TypeScript SDK

   // 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

   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"]
     }'
   

   Webhook Handler

   // 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);
   
6. View Messages & Threads

   Retrieve and search through your messages:

   List Messages

   // Get all messages in an inbox
   const messages = await client.inbox.message.list(inbox.id);
   
   console.log(`Total messages: ${messages.length}`);
   

   Search Messages

   // 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 Threads

   // 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 Message

   // 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 [e-mail] inbox and use webhooks to automatically route incoming support emails to your ticketing system.

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

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