Skip to main content

​
Send Message

curl -X POST https://api.sendook.com/v1/inboxes/inbox_123/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["[email protected]"],
    "subject": "Hello from Sendook",
    "text": "This is a plain text message.",
    "html": "<p>This is an <strong>HTML</strong> message.</p>"
  }'
Send an email message from an inbox. This creates a new thread and sends the message.
Rate limited to 100 requests per hour per organization.

​
Path Parameters

​
inboxId
string
required
The unique identifier of the inbox to send from.

​
Request Body

​
to
string[]
required
Array of recipient email addresses.Example: ["[email protected]", "[email protected]"]
​
cc
string[]
Array of CC recipient email addresses.
​
bcc
string[]
Array of BCC recipient email addresses.
​
subject
string
required
Subject line of the email.
​
text
string
required
Plain text version of the email body.
​
html
string
required
HTML version of the email body.
​
labels
string[]
Custom labels to organize the message.Example: ["important", "customer-support"]
​
attachments
array
Array of attachment objects.

​
Response

​
id
string
Unique identifier for the message.
​
organizationId
string
ID of the organization that owns this message.
​
inboxId
string
ID of the inbox this message belongs to.
​
threadId
string
ID of the thread this message belongs to.
​
fromInboxId
string
ID of the inbox the message was sent from.
​
from
string
Email address the message was sent from.
​
to
string[]
Array of recipient email addresses.
​
cc
string[]
Array of CC recipient email addresses.
​
bcc
string[]
Array of BCC recipient email addresses.
​
subject
string
Subject line of the email.
​
text
string
Plain text version of the email body.
​
html
string
HTML version of the email body.
​
labels
string[]
Custom labels assigned to the message.
​
attachments
array
Array of attachment objects.
​
externalMessageId
string
External message ID from the email service provider (AWS SES).
​
status
string
Status of the message. One of: sent, received, delivered, bounced, complained, rejected.
​
createdAt
string
ISO 8601 timestamp of when the message was created.
​
updatedAt
string
ISO 8601 timestamp of when the message was last updated.

​
Error Responses

404 Not Found
  • "Inbox not found" - The inbox doesn’t exist or doesn’t belong to your organization
429 Too Many Requests
  • Rate limit exceeded (100 requests per hour)

​
Webhook Events

Sending a message triggers the following webhook event:
  • message.sent - Fired when the message is successfully sent

​
Reply to Message

curl -X POST https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456/reply \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Thank you for your message.",
    "html": "<p>Thank you for your message.</p>"
  }'
Reply to an existing message. The reply is automatically added to the same thread and sent to the original sender.
Rate limited to 100 requests per hour per organization.

​
Path Parameters

​
inboxId
string
required
The unique identifier of the inbox to send from.
​
messageId
string
required
The unique identifier of the message to reply to.

​
Request Body

​
text
string
required
Plain text version of the reply.
​
html
string
required
HTML version of the reply.

​
Response

Returns a message object with the same fields as the Send Message endpoint.
​
id
string
Unique identifier for the reply message.
​
threadId
string
ID of the thread (same as the original message).
​
from
string
Email address the reply was sent from (the inbox email).
​
to
string[]
Array containing the original sender’s email address.
​
subject
string
Subject line prefixed with “Re: ”.
​
text
string
Plain text version of the reply.
​
html
string
HTML version of the reply.

​
Error Responses

404 Not Found
  • "Inbox not found" - The inbox doesn’t exist or doesn’t belong to your organization
  • "Message not found" - The message doesn’t exist or doesn’t belong to your organization
429 Too Many Requests
  • Rate limit exceeded (100 requests per hour)

​
Webhook Events

Replying to a message triggers the following webhook event:
  • message.sent - Fired when the reply is successfully sent

​
List Messages

curl "https://api.sendook.com/v1/inboxes/inbox_123/messages?query=important" \
  -H "Authorization: Bearer YOUR_API_KEY"
Retrieve all messages in an inbox with optional search filtering.

​
Path Parameters

​
inboxId
string
required
The unique identifier of the inbox.

​
Query Parameters

​
query
string
Search query to filter messages. Searches across subject, text, and sender fields.Example: "important"

​
Response

Returns an array of message objects.
​
id
string
Unique identifier for the message.
​
organizationId
string
ID of the organization that owns this message.
​
inboxId
string
ID of the inbox this message belongs to.
​
threadId
string
ID of the thread this message belongs to.
​
from
string
Email address the message was sent from.
​
to
string[]
Array of recipient email addresses.
​
subject
string
Subject line of the email.
​
text
string
Plain text version of the email body.
​
html
string
HTML version of the email body.
​
status
string
Status of the message.
​
createdAt
string
ISO 8601 timestamp of when the message was created.

​
Error Responses

404 Not Found
  • "Inbox not found" - The inbox doesn’t exist or doesn’t belong to your organization

​
Get Message

curl https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456 \
  -H "Authorization: Bearer YOUR_API_KEY"
Retrieve a specific message by its ID.

​
Path Parameters

​
inboxId
string
required
The unique identifier of the inbox.
​
messageId
string
required
The unique identifier of the message to retrieve.

​
Response

​
id
string
Unique identifier for the message.
​
organizationId
string
ID of the organization that owns this message.
​
inboxId
string
ID of the inbox this message belongs to.
​
threadId
string
ID of the thread this message belongs to.
​
fromInboxId
string
ID of the inbox the message was sent from (if applicable).
​
from
string
Email address the message was sent from.
​
toInboxId
string
ID of the inbox the message was sent to (if applicable).
​
to
string[]
Array of recipient email addresses.
​
cc
string[]
Array of CC recipient email addresses.
​
bcc
string[]
Array of BCC recipient email addresses.
​
subject
string
Subject line of the email.
​
text
string
Plain text version of the email body.
​
html
string
HTML version of the email body.
​
labels
string[]
Custom labels assigned to the message.
​
attachments
array
Array of attachment objects with content, name, and contentType fields.
​
externalMessageId
string
External message ID from the email service provider.
​
status
string
Status of the message. One of: sent, received, delivered, bounced, complained, rejected.
​
createdAt
string
ISO 8601 timestamp of when the message was created.
​
updatedAt
string
ISO 8601 timestamp of when the message was last updated.

​
Error Responses

404 Not Found
  • "Message not found" - The message doesn’t exist or doesn’t belong to your organization

Build docs developers (and LLMs) love

Get started for freeTalk to us