Creates a new email send in the system. The send configuration includes the email to send, the list to send to, optional segments, sender information, and timing configuration based on the send type.

Send Types

Different send types require different fields:

ABSOLUTE

Send at a specific date and time.

• Requires: sendAtDateTime (ISO-8601 format with time)

SMART_SEND

Send on a specific date using AI-optimized sending times for each subscriber.

• Requires: sendAtDate (YYYY-MM-DD format)

RELATIVE_AFTER_DATE

Send relative to a date field (e.g., 5 days after signup date).

• Requires: referenceField, relativeDays, relativeHours, relativeMinutes, relativeDaysName
• relativeDaysName: Allowed days (e.g., "MON-TUE-WED-THU-FRI")

RELATIVE_AFTER_MINUTES

Send after a specified number of hours and minutes from a reference field.

• Requires: referenceField, relativeHoursNumber, relativeMinutesNumber
• Useful for short-term follow-ups (e.g., 2 hours after action)

SUBSCRIPTION

Trigger on subscription event.

• Optional: formId (if null, triggers on any subscription; if specified, only on that form)

DATA_UPDATE

Trigger on data modification event.

• Optional: formId (if null, triggers on any update; if specified, only on that form)

Default Behavior

• If name is not provided, it will be auto-generated from the email name
• If subject is not provided, the email's subject will be used
• If fromName is not provided, only the email address will be shown
• Sends are created in inactive state by default (activate via update)

Validation

• listId must be a valid list belonging to your account
• emailId must be a valid email belonging to your account
• fromEmail must be an authenticated sender email for your account
• segmentIds must be valid segments belonging to the specified list
• referenceField must be a valid date/datetime field in the list