Send Single Email

post

https://api.campaignrefinery.com/rest/send/single_email

Send a single email to a contact using raw HTML content. Supports two recipient modes: by email address or by contact UUID. When using the "By Email Address" mode, the address must already exist as a contact in the account; if it does not, the API returns 404 "Contact not found".

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

Recipient's email address (required if no contact UUID is provided)

contact_id

string

Recipient's contact UUID (required if email not provided)

subject

string

required

Email subject line (required)

content

string

required

HTML email content (required)

domain_id

string

required

Domain settings for Managed users, Sending Domains for BYO users, copy the uuid (required)

footer_id

string

required

Footer template ID (required)

from_name

string

Custom sender name to display in the email From field. If not provided, the default sender name from your domain settings will be used.

from_email

string

Custom sender email address. Must use the same domain as your verified sending domain (e.g., if your domain is example.com, from_email must be [email protected]). If not provided, the default sender email from your domain settings will be used.

replyto_name

string

Custom reply-to name. If not provided, replies will use the default settings.

replyto_email

string

Custom reply-to email address. If not provided, replies will use the default settings.

preview_text

string

length ≤ 150

Preview text shown in email clients before opening the email (max 150 characters).

custom_params

object

Custom metadata key-value pairs for tracking the send request (max 10 keys, max 1024 characters per value).

suppression_list_ids

array of strings

List of suppression list UUIDs to check against

suppression_list_ids

to_name

string

Custom recipient display name for the To field. If not provided, the contact's name from their record will be used.

custom_headers

object

Custom X- headers to include in the email (max 10). All keys must start with 'X-' and values must be strings (max 998 characters each).

attachments

array of objects

length ≤ 5

File attachments to include in the email (max 5). Individual attachments max 10MB, total max 25MB.

attachments

Responses

200Email sent successfully

401Missing or invalid API key

404Contact not found. Returned when the recipient email address does not match an existing contact in the account (By Email Address mode) or when the contact UUID is not found.

422Validation error or sending failed