Skip to main content
POST
/
email
cURL
curl --request POST \
  --url https://api.contiguity.com/send/email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "[email protected]",
  "from": "Contiguity <[email protected]>",
  "subject": "Hello, world!",
  "body": {
    "text": "Hello, world!",
    "html": "<p>Hello, world!</p>"
  },
  "reply_to": "[email protected]",
  "cc": [
    "[email protected]",
    "[email protected]"
  ],
  "bcc": [
    "[email protected]"
  ],
  "headers": [
    {
      "name": "X-Priority",
      "value": "1"
    }
  ]
}
'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1761968887641,
  "api_version": "v2025.10.31",
  "object": "response",
  "data": {
    "email_id": "eml_1234567890"
  }
}
from behavior is highly dependent on your account’s setup!
The sender email configuration depends on your account setup:
  • If you haven’t verified a domain: You can only use Contiguity’s email infrastructure. Simply provide your sender name (e.g. ‘Contiguity’).
  • If you have verified a domain: You can either:

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
to
required

Recipient email address(es). Can be a string or array of up to 10 addresses

Example:

"[email protected]"

​
from
string
required

Accepts: "Example [email protected]" or "Contiguity" or "[email protected]"

Example:

"Contiguity <[email protected]>"

​
subject
string
required

Subject of the email

Example:

"Hello, world!"

​
body
object
required
​
reply_to
string

Reply-to email address

Example:

"[email protected]"

​
cc

Carbon copy email address(es). Can be a string or array of up to 10 addresses

Example:
[
  "[email protected]",
  "[email protected]"
]
​
bcc

Blind carbon copy email address(es). Can be a string or array of up to 10 addresses

Example:
["[email protected]"]
​
headers
object[]

Custom email headers

Example:
[{ "name": "X-Priority", "value": "1" }]

Response

Send an email

​
id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

​
timestamp
number
required
Example:

1761968887641

​
api_version
string
required
Example:

"v2025.10.31"

​
object
string
required
Example:

"response"

​
data
object
required