Skip to main content
POST
/
api
/
v1
/
email
/
send
Send Email
curl --request POST \
  --url https://app.botmailroom.com/api/v1/email/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inbox_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "to_addresses": [
    {
      "address": "<string>",
      "name": "<string>"
    }
  ],
  "cc_addresses": [
    {
      "address": "<string>",
      "name": "<string>"
    }
  ],
  "bcc_addresses": [
    {
      "address": "<string>",
      "name": "<string>"
    }
  ],
  "reply_to_addresses": [
    {
      "address": "<string>",
      "name": "<string>"
    }
  ],
  "subject": "<string>",
  "idempotency_key": "<string>",
  "plain_text": "<string>",
  "html": "<string>",
  "alternative_content": false,
  "existing_email_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "message_type": "new",
  "attachment_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "open_and_click_tracking": true
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
inbox_id
string<uuid>
required

The ID of the inbox to send the email from

​
to_addresses
EmailAddress · object[]
​
cc_addresses
EmailAddress · object[]
​
bcc_addresses
EmailAddress · object[]
​
reply_to_addresses
EmailAddress · object[]
​
subject
string | null

The subject of the email. If not provided, the subject of the original email will be used. Must be provided for new emails

​
idempotency_key
string | null

A unique identifier for the email. If the same request is sent multiple times with the same idempotency key, only the first email will be sent

​
plain_text
string | null

The plain text content of the email. Can be null if the email is only available in html

​
html
string | null

The html content of the email. Can be null if the email is only available in plain text

​
alternative_content
boolean
default:false

If true, html and plain_text are alternative representations of the same content

​
existing_email_id
string<uuid> | null

The BotMailRoom ID of the email to reply to or forward. Can be null if the email is a new email

​
message_type
enum<string>
Available options:
forward,
reply,
new
​
attachment_ids
string<uuid>[]

The IDs of the attachments to include in the email from the attachments pool. See here for more information on the attachments pool

​
open_and_click_tracking
boolean | null

If true, open and click tracking will be enabled for the email. If false, open and click tracking will be disabled for the email. If null, open and click tracking will be enabled if the inbox has open and click tracking enabled

Response

Successful Response

​
id
string<uuid>
required

The ID of the email