Sendook Email SDK (Restricted)

Read and send emails from an existing Sendook inbox.

Scope Limitations: This skill can ONLY read and send emails from a pre-configured inbox. You CANNOT create or delete inboxes, manage domains, manage webhooks, or manage API keys. Do not attempt these operations — they are not available.

Installation

Install the skill into your OpenClaw workspace:

clawhub install sendook-openclaw

This adds the skill to your workspace's skills/ directory. OpenClaw will automatically pick it up on the next session start.

Environment Variables

Set these in your OpenClaw workspace or shell environment:

• SENDOOK_API_KEY — Your Sendook API key
• SENDOOK_INBOX_ID — The inbox ID this agent is allowed to use

Setup

Install the SDK (npm | source):

npm install @sendook/node

import Sendook from "@sendook/node";

const client = new Sendook(process.env.SENDOOK_API_KEY);
const INBOX_ID = process.env.SENDOOK_INBOX_ID;

Both environment variables are required. Use a least-privileged API key scoped to the target inbox only.

Reading Emails

List Messages

// List all messages in the inbox
const messages = await client.inbox.message.list(INBOX_ID);

// Search messages (regex-based search across to/from/cc, subject, and body)
const results = await client.inbox.message.list(INBOX_ID, "invoice");

# List all messages
curl https://api.sendook.com/v1/inboxes/$SENDOOK_INBOX_ID/messages \
  -H "Authorization: Bearer $SENDOOK_API_KEY"

# Search messages
curl "https://api.sendook.com/v1/inboxes/$SENDOOK_INBOX_ID/messages?query=invoice" \
  -H "Authorization: Bearer $SENDOOK_API_KEY"

Get Message

const message = await client.inbox.message.get(INBOX_ID, "msg_def456");

curl https://api.sendook.com/v1/inboxes/$SENDOOK_INBOX_ID/messages/msg_def456 \
  -H "Authorization: Bearer $SENDOOK_API_KEY"

Response:

{
  "id": "msg_def456",
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Question about my order",
  "text": "Hi, I have a question about order #12345...",
  "html": "<p>Hi, I have a question about order #12345...</p>",
  "labels": [],
  "threadId": "thread_ghi789",
  "createdAt": "2025-01-15T10:35:00Z"
}

List Threads

const threads = await client.inbox.thread.list(INBOX_ID);

curl https://api.sendook.com/v1/inboxes/$SENDOOK_INBOX_ID/threads \
  -H "Authorization: Bearer $SENDOOK_API_KEY"

Get Thread

Retrieve a full conversation with all messages.

const thread = await client.inbox.thread.get(INBOX_ID, "thread_ghi789");
// thread.messages contains all messages in the conversation

curl https://api.sendook.com/v1/inboxes/$SENDOOK_INBOX_ID/threads/thread_ghi789 \
  -H "Authorization: Bearer $SENDOOK_API_KEY"