Send Message

POST {{baseUrl}}/messages/?attachment=<>&bcc=<>&cc=<>&from=<>&h:X-My-Header=<>&html=<>&inline=<>&o:campaign=<>&o:deliverytime=<>&o:dkim=<>&o:tag=<>&o:testmode=<>&o:tracking=<>&o:tracking-clicks=<>&o:tracking-opens=<>&subject=<>&text=<>&to=<>&v:my-var=<>

Sends a message by assembling it from the components. Note that you can specify most parameters multiple times, HTTP supports this out of the box. This makes sense for parameters like cc, to or attachment.

Request Params

KeyDatatypeRequiredDescription
attachmentstringFile attachment. You can post multiple attachmentnvalues. Important: You must use multipart/form-datanencoding when sending attachments.
bccstringSame as To but for Bcc
ccstringSame as To but for Cc
fromstringEmail address for From header
h:X-My-Headerstringh: prefix followed by an arbitrary value allows to appendna custom MIME header to the message (X-My-Headernin this case). For example, h:Reply-To to specify Reply-Tonaddress.
htmlstringBody of the message. (HTML version)
inlinestringAttachment with inline disposition. Can be used tonsend inline images (see example).nYou can post multiple inline values.
o:campaignstringId of the campaign the message belongs to. SeenCampaign Analytics for details.
o:deliverytimestringDesired time of delivery. See Date Format. Note:nMessages can be scheduled for a maximum of 3 days in thenfuture.
o:dkimstringEnables/disabled DKIM signatures on per-message basis.nPass yes or no
o:tagstringTag string. See Tagging for more information.
o:testmodestringEnables sending in test mode. Pass yes if needed.nSee Sending in Test Mode
o:trackingstringToggles tracking on a per-message basis, seenTracking Messages for details. Pass yes or no.
o:tracking-clicksstringToggles clicks tracking on a per-message basis. Has highernpriority than domain-level setting. Pass yes, nonor htmlonly.
o:tracking-opensstringToggles opens tracking on a per-message basis. Has highernpriority than domain-level setting. Pass yes or no.
subjectstringMessage subject
textstringBody of the message. (text version)
tostringEmail address of the recipient(s).nExample: &quot;Bob &lt;bob&#64;host.com&gt;&quot;. You can use commas tonseparate multiple recipients.nMake sure to include all To, Cc and Bccnrecipients of the message.
v:my-varstringv: prefix followed by an arbitrary name allows tonattach a custom JSON data to the message.nSee Attaching Data to Messages for more information.