Skip to content
  • Auto
  • Light
  • Dark
Get Started

Send

Send
post/v1/email

Send emails

Body Parameters
attachmentsarray of object
optional

A list of attachments to add to the email

Hide ParametersShow Parameters
contentstring
filenamestring
contentIdstring
optional
dispositionstring
optional
typestring
optional
bccunion
optional
string OR object OR array of string OR object

A single email or list of emails for one of the address fields

Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
EmailDataListarray of union
Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
ccunion
optional
string OR object OR array of string OR object

A single email or list of emails for one of the address fields

Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
EmailDataListarray of union
Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
fromunion
optional
string OR object

An email address and name

Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
headersmap
optional

A set of headers to include the email that you send

htmlstring
optional

HTML content of the email. Can be specified alongside text

replyToListunion
optional
object OR array of object

A reply-to list of email addresses

Hide ParametersShow Parameters
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
EmailListarray of object
Hide ParametersShow Parameters
emailstring
namestring
optional
subjectstring
optional

The subject line of the email

textstring
optional

Text content of the email, for email clients that may not support HTML

tounion
optional
string OR object OR array of string OR object

A single email or list of emails for one of the address fields

Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
EmailDataListarray of union
Hide ParametersShow Parameters
UnionMember0string
EmailNameAndAddressobject

An email address and name

Hide ParametersShow Parameters
emailstring
namestring
optional
Returns
messagestring
curl https://api.val.town/v1/email \
    -H 'Content-Type: application/json'
200 Example
{
  "message": "message"
}