Messages

Send, receive, and manage email messages

Send Message

cURL

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": ["[e-mail]"],
    "subject": "Hello from Sendook",
    "text": "This is a plain text message.",
    "html": "<p>This is an <strong>HTML</strong> message.</p>"
  }'

const response = await fetch('https://api.sendook.com/v1/inboxes/inbox_123/messages/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: ['[e-mail]'],
    subject: 'Hello from Sendook',
    text: 'This is a plain text message.',
    html: '<p>This is an <strong>HTML</strong> message.</p>'
  })
});

const message = await response.json();

import requests

response = requests.post(
    'https://api.sendook.com/v1/inboxes/inbox_123/messages/send',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'to': ['[e-mail]'],
        'subject': 'Hello from Sendook',
        'text': 'This is a plain text message.',
        'html': '<p>This is an <strong>HTML</strong> message.</p>'
    }
)

message = response.json()

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: ["[e-mail]", "[e-mail]"]

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.

Show Attachment Object

content · string · required

Base64-encoded content of the attachment.

name · string

Filename of the attachment.

Example: "document.pdf"

contentType · string

MIME type of the attachment.

Example: "application/pdf"

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

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

const response = await fetch('https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456/reply', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Thank you for your message.',
    html: '<p>Thank you for your message.</p>'
  })
});

const reply = await response.json();

import requests

response = requests.post(
    'https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456/reply',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'text': 'Thank you for your message.',
        'html': '<p>Thank you for your message.</p>'
    }
)

reply = response.json()

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

curl "https://api.sendook.com/v1/inboxes/inbox_123/messages?query=important" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/inboxes/inbox_123/messages?query=important', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const messages = await response.json();

import requests

response = requests.get(
    'https://api.sendook.com/v1/inboxes/inbox_123/messages',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'query': 'important'}
)

messages = response.json()

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

curl https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456 \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const message = await response.json();

import requests

response = requests.get(
    'https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

message = response.json()

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