> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/getrupt/sendook/llms.txt
> Use this file to discover all available pages before exploring further.
# Messages
> Send, receive, and manage email messages
## Send Message
```bash cURL theme={null}
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": ["recipient@example.com"],
"subject": "Hello from Sendook",
"text": "This is a plain text message.",
"html": "This is an HTML message.
"
}'
```
```javascript Node.js theme={null}
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: ['recipient@example.com'],
subject: 'Hello from Sendook',
text: 'This is a plain text message.',
html: 'This is an HTML message.
'
})
});
const message = await response.json();
```
```python Python theme={null}
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': ['recipient@example.com'],
'subject': 'Hello from Sendook',
'text': 'This is a plain text message.',
'html': 'This is an HTML message.
'
}
)
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
The unique identifier of the inbox to send from.
### Request Body
Array of recipient email addresses.
Example: `["recipient@example.com", "another@example.com"]`
Array of CC recipient email addresses.
Array of BCC recipient email addresses.
Subject line of the email.
Plain text version of the email body.
HTML version of the email body.
Custom labels to organize the message.
Example: `["important", "customer-support"]`
Array of attachment objects.
Base64-encoded content of the attachment.
Filename of the attachment.
Example: `"document.pdf"`
MIME type of the attachment.
Example: `"application/pdf"`
### Response
Unique identifier for the message.
ID of the organization that owns this message.
ID of the inbox this message belongs to.
ID of the thread this message belongs to.
ID of the inbox the message was sent from.
Email address the message was sent from.
Array of recipient email addresses.
Array of CC recipient email addresses.
Array of BCC recipient email addresses.
Subject line of the email.
Plain text version of the email body.
HTML version of the email body.
Custom labels assigned to the message.
Array of attachment objects.
External message ID from the email service provider (AWS SES).
Status of the message. One of: `sent`, `received`, `delivered`, `bounced`, `complained`, `rejected`.
ISO 8601 timestamp of when the message was created.
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
```bash cURL theme={null}
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": "Thank you for your message.
"
}'
```
```javascript Node.js theme={null}
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: 'Thank you for your message.
'
})
});
const reply = await response.json();
```
```python Python theme={null}
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': 'Thank you for your message.
'
}
)
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
The unique identifier of the inbox to send from.
The unique identifier of the message to reply to.
### Request Body
Plain text version of the reply.
HTML version of the reply.
### Response
Returns a message object with the same fields as the Send Message endpoint.
Unique identifier for the reply message.
ID of the thread (same as the original message).
Email address the reply was sent from (the inbox email).
Array containing the original sender's email address.
Subject line prefixed with "Re: ".
Plain text version of the reply.
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
```bash cURL theme={null}
curl "https://api.sendook.com/v1/inboxes/inbox_123/messages?query=important" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript Node.js theme={null}
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();
```
```python Python theme={null}
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
The unique identifier of the inbox.
### Query Parameters
Search query to filter messages. Searches across subject, text, and sender fields.
Example: `"important"`
### Response
Returns an array of message objects.
Unique identifier for the message.
ID of the organization that owns this message.
ID of the inbox this message belongs to.
ID of the thread this message belongs to.
Email address the message was sent from.
Array of recipient email addresses.
Subject line of the email.
Plain text version of the email body.
HTML version of the email body.
Status of the message.
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
```bash cURL theme={null}
curl https://api.sendook.com/v1/inboxes/inbox_123/messages/msg_456 \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript Node.js theme={null}
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();
```
```python Python theme={null}
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
The unique identifier of the inbox.
The unique identifier of the message to retrieve.
### Response
Unique identifier for the message.
ID of the organization that owns this message.
ID of the inbox this message belongs to.
ID of the thread this message belongs to.
ID of the inbox the message was sent from (if applicable).
Email address the message was sent from.
ID of the inbox the message was sent to (if applicable).
Array of recipient email addresses.
Array of CC recipient email addresses.
Array of BCC recipient email addresses.
Subject line of the email.
Plain text version of the email body.
HTML version of the email body.
Custom labels assigned to the message.
Array of attachment objects with `content`, `name`, and `contentType` fields.
External message ID from the email service provider.
Status of the message. One of: `sent`, `received`, `delivered`, `bounced`, `complained`, `rejected`.
ISO 8601 timestamp of when the message was created.
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