Emails
Send an email
Send an email immediately or schedule it for later using the scheduled_at parameter. Supports HTML/text content, attachments, and custom headers.
POST
/
api
/
e2
/
emails
TypeScript
import Inbound from "inboundemail";
const inbound = new Inbound();
const result = await inbound.emails.send({
from: "agent@example.com",
to: "alex@example.com",
subject: "Your support request",
text: "How can we help?"
});curl -X POST 'https://inbound.new/api/e2/emails' \
-H "Authorization: Bearer $INBOUND_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"from": "agent@example.com",
"to": "alex@example.com",
"subject": "Your support request",
"text": "How can we help?"
}'import requests
url = "https://inbound.new/api/e2/emails"
payload = {
"from": "<string>",
"to": "<string>",
"subject": "<string>",
"html": "<string>",
"text": "<string>",
"cc": "<string>",
"bcc": "<string>",
"reply_to": "<string>",
"headers": {},
"attachments": [
{
"filename": "<string>",
"content": "<string>",
"content_type": "<string>",
"content_id": "<string>",
"path": "<string>"
}
],
"tags": [
{
"name": "<string>",
"value": "<string>"
}
],
"message_id": "<string>",
"scheduled_at": "<string>",
"timezone": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
from: '<string>',
to: '<string>',
subject: '<string>',
html: '<string>',
text: '<string>',
cc: '<string>',
bcc: '<string>',
reply_to: '<string>',
headers: {},
attachments: [
{
filename: '<string>',
content: '<string>',
content_type: '<string>',
content_id: '<string>',
path: '<string>'
}
],
tags: [{name: '<string>', value: '<string>'}],
message_id: '<string>',
scheduled_at: '<string>',
timezone: '<string>'
})
};
fetch('https://inbound.new/api/e2/emails', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://inbound.new/api/e2/emails",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from' => '<string>',
'to' => '<string>',
'subject' => '<string>',
'html' => '<string>',
'text' => '<string>',
'cc' => '<string>',
'bcc' => '<string>',
'reply_to' => '<string>',
'headers' => [
],
'attachments' => [
[
'filename' => '<string>',
'content' => '<string>',
'content_type' => '<string>',
'content_id' => '<string>',
'path' => '<string>'
]
],
'tags' => [
[
'name' => '<string>',
'value' => '<string>'
]
],
'message_id' => '<string>',
'scheduled_at' => '<string>',
'timezone' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://inbound.new/api/e2/emails"
payload := strings.NewReader("{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://inbound.new/api/e2/emails")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://inbound.new/api/e2/emails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"message_id": "<string>",
"scheduled_at": "<string>",
"status": "sent",
"timezone": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Your Inbound API key. Include it in the Authorization header as: Bearer
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Sender email address
Recipient email address(es)
Email subject
HTML content of the email
Plain text content of the email
Custom email headers
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Client Message-ID retained in the mailbox's Sent copy, e.g. id@example.com. SES assigns its own delivery Message-ID. Generated for mailbox sends when omitted.
Required string length:
3 - 500ISO 8601 date or natural language for scheduling
Timezone for natural language parsing
Was this page helpful?
⌘I
TypeScript
import Inbound from "inboundemail";
const inbound = new Inbound();
const result = await inbound.emails.send({
from: "agent@example.com",
to: "alex@example.com",
subject: "Your support request",
text: "How can we help?"
});curl -X POST 'https://inbound.new/api/e2/emails' \
-H "Authorization: Bearer $INBOUND_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"from": "agent@example.com",
"to": "alex@example.com",
"subject": "Your support request",
"text": "How can we help?"
}'import requests
url = "https://inbound.new/api/e2/emails"
payload = {
"from": "<string>",
"to": "<string>",
"subject": "<string>",
"html": "<string>",
"text": "<string>",
"cc": "<string>",
"bcc": "<string>",
"reply_to": "<string>",
"headers": {},
"attachments": [
{
"filename": "<string>",
"content": "<string>",
"content_type": "<string>",
"content_id": "<string>",
"path": "<string>"
}
],
"tags": [
{
"name": "<string>",
"value": "<string>"
}
],
"message_id": "<string>",
"scheduled_at": "<string>",
"timezone": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
from: '<string>',
to: '<string>',
subject: '<string>',
html: '<string>',
text: '<string>',
cc: '<string>',
bcc: '<string>',
reply_to: '<string>',
headers: {},
attachments: [
{
filename: '<string>',
content: '<string>',
content_type: '<string>',
content_id: '<string>',
path: '<string>'
}
],
tags: [{name: '<string>', value: '<string>'}],
message_id: '<string>',
scheduled_at: '<string>',
timezone: '<string>'
})
};
fetch('https://inbound.new/api/e2/emails', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://inbound.new/api/e2/emails",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'from' => '<string>',
'to' => '<string>',
'subject' => '<string>',
'html' => '<string>',
'text' => '<string>',
'cc' => '<string>',
'bcc' => '<string>',
'reply_to' => '<string>',
'headers' => [
],
'attachments' => [
[
'filename' => '<string>',
'content' => '<string>',
'content_type' => '<string>',
'content_id' => '<string>',
'path' => '<string>'
]
],
'tags' => [
[
'name' => '<string>',
'value' => '<string>'
]
],
'message_id' => '<string>',
'scheduled_at' => '<string>',
'timezone' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://inbound.new/api/e2/emails"
payload := strings.NewReader("{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://inbound.new/api/e2/emails")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://inbound.new/api/e2/emails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"from\": \"<string>\",\n \"to\": \"<string>\",\n \"subject\": \"<string>\",\n \"html\": \"<string>\",\n \"text\": \"<string>\",\n \"cc\": \"<string>\",\n \"bcc\": \"<string>\",\n \"reply_to\": \"<string>\",\n \"headers\": {},\n \"attachments\": [\n {\n \"filename\": \"<string>\",\n \"content\": \"<string>\",\n \"content_type\": \"<string>\",\n \"content_id\": \"<string>\",\n \"path\": \"<string>\"\n }\n ],\n \"tags\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"message_id\": \"<string>\",\n \"scheduled_at\": \"<string>\",\n \"timezone\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"message_id": "<string>",
"scheduled_at": "<string>",
"status": "sent",
"timezone": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}