POST /v1/email — val-town-api

emails

Send emails

post/v1/email

Request body

subjectstring

The subject line of the email

headersobject

A set of headers to include the email that you send

textstring

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

htmlstring

HTML content of the email. Can be specified alongside text

Response

Email accepted to be sent

messagestring required

Changes

Changed in 4 of the 46 revisions of this API.3251

May 14, 2026eee85d2eafce25See the full diff
- ●
  the bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the bcc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the bcc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the bcc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the bcc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #1: EmailData]/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the cc/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the from/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the from/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the from/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the replyToList/anyOf[subschema #1: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the replyToList/anyOf[subschema #1: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the replyToList/anyOf[subschema #2: EmailList]/items/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the replyToList/anyOf[subschema #2: EmailList]/items/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the to/anyOf[subschema #1: EmailData]/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the to/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the to/anyOf[subschema #1: EmailData]/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
- ●
  the to/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #1]/ request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the to/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/email request property's maxLength was set to 320
  request-property-max-length-set
- ●
  the to/anyOf[subschema #2: EmailDataList]/items/anyOf[subschema #2: EmailNameAndAddress]/name request property's maxLength was set to 256
  request-property-max-length-set
Apr 20, 20268f22304950dd1See the full diff
- ▲
  request body became required
  request-body-became-required
Jan 15, 2026788eacc57f2511See the full diff
- ▲
  removed the success response with the status 200
  response-success-status-removed
- ○
  added the success response with the status 202
  response-success-status-added
Nov 18, 20254596d0810d3d1See the full diff
- ▲
  the html request property's minLength was increased from 0 to 1
  request-property-min-length-increased

Full history