Send a standard email

post

https://api.smtp2go.com/v3/email/send

Send an email by passing a JSON email object

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

We recommend setting the parameter fastaccept to "true", as this is a much faster sending method, and will become the default method in the near future.

Note this endpoint returns 200 OK even if there are errors in the reponse, please check the failed and failures properties to see any processing errors.

Body Params

sender

string

required

The name and email address to send from, in the format Name <[email protected]>

array of strings

required

An array of names and email addresses (up to 100) to send to, in the format Name <[email protected]>

to*

array of strings

An array of names and email addresses (up to 100) to CC, in the format Name <[email protected]>

bcc

array of strings

An array of names and email addresses (up to 100) to BCC, in the format Name <[email protected]>

bcc

subject

string

The subject of the email to be sent, Note: if template_id if passed this field is ignored.

If you would like to set a custom subject in the template_data, use a variable ({{custom_subject}} for instance) as the value of the templates subject and then set its value in template_data respectively.

html_body

string

A HTML encoded email body. Either html_body or text_body is required if template_id is not passed. If template_id is passed this field is ignored.

Warning:

To correctly track clicking of URLs you must:
- Enable click tracking for the API key
- Insert a full anchor HTML element (not just the URL)
- Include "https://" at the start of the HREF property

text_body

string

A plain text email body. Either html_body or text_body is required if template_id is not passed. If template_id is passed this field is ignored.

custom_headers

array of objects

An array of custom header objects to be applied to the email. For example, a Reply-To email can be specified here, with header Reply-To and value [email protected]. For sending purposes the following headers are not allowed Content-Type, Content-Transfer-Encoding and MIME-Version.

custom_headers

attachments

array of objects

An array of attachment objects to be attached to the email

attachments

inlines

array of objects

An array of images to be inlined into the email. Use an image in content as <img src="cid:filename"/>

inlines

template_id

string

The ID of the template you wish to use

template_data

json

When a template_id is provided, include the pass-through values in the format {"variable1": "value1", "variable2": "value2"}

schedule

string

A timestamp that when passed allows you to schedule an email for sending. Must be in the future and within the next 3 days.
The api response will include a schedule_id property which can then be used alongside webhooks (An X-Smtp2go-Schedule-Id header is added to the sent email corresponds to this id). A total of 50,000 emails can be queued at any one time.

fastaccept

boolean

Defaults to false

If true, the email will be accepted immediately and sent in a background process. Use webhooks if you need information about final delivery to the recipient. This will soon become the default method of sending via API.

Responses

200Email sent

400400