Send an email or a reply to a visible Calling contact

Workspace and recipient are resolved server-side. Email opt-out and Sandbox Mode are checked before sending. Reply headers come only from the original email under the same contact and workspace. Unknown send outcomes must not be retried automatically.

POST

https://api.channelautomation.com/api/call-center/contacts/{contactId}/emails

Authorization

BearerAuth
HTTP Bearer (JWT)
required

Path parameters

contactId
string
required
format: uuid

Request body JSON required

recipient
string
required
Current displayed recipient; compared server-side and never overrides the contact address

format: email
subject
string
required
maxLength: 200
message
string
required
maxLength: 20000
replyToId
optional
string
format: uuid

Returns

200

Provider accepted the email; persisted indicates history-save outcome

400

Invalid subject

401

Sign-in required

403

Access

404

Contact or original email not in selected workspace/contact

409

Missing email address or usable thread reference

502

Acceptance unknown; check history before another send

503

Access or recipient could not be verified

Send an email or a reply to a visible Calling contact

curl --request POST \
  --url 'https://api.channelautomation.com/api/call-center/contacts/<contactId>/emails' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipient": "[email protected]",
  "subject": "string",
  "message": "string",
  "replyToId": "019c0f01-e197-45eb-8a17-c9811c373be9"
}
'

const url = 'https://api.channelautomation.com/api/call-center/contacts/<contactId>/emails';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    recipient: '[email protected]',
    subject: 'string',
    message: 'string',
    replyToId: '019c0f01-e197-45eb-8a17-c9811c373be9'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/call-center/contacts/<contactId>/emails"

payload = {
    "recipient": "[email protected]",
    "subject": "string",
    "message": "string",
    "replyToId": "019c0f01-e197-45eb-8a17-c9811c373be9"
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)