Send custom HTML email

If you'd like to set your own HTML for an email, use the html parameter. 
Sending HTML over email is a mess. Knowing what email clients support what HTML features can be a full-time job. 
We recommend using our Visual Drag-and-Drop editor to create a standard-compliant email that will look properly in all email clients. Learn more​
To send a custom HTML email, send a request to the API as follows:
const axios = require('axios');
​
// Send a POST request
axios({
  method: 'post',
  url: 'https://api.encharge.io/v1/emails/send?token=yourAPIKey',
  data: {
    "to": "[email protected]",
    "from": "[email protected]",
    "subject": "Welcome",
    "html": "<div>Hello and welcome, <b>{{ person.firstName }}</b>!</div>",
    /**
   * Optionally, you can include a dictionary of fields to be replaced.
   * For example, passing
   * `{ "loginURL": "https://app.encharge.io/login/3n2l3ad99"}`
   * will replace
   * `{{ loginURL }}` in the email html or subject.
   */
    "templateProperties": {
      "loginURL": "https://app.encharge.io/login/3n2l3ad99"
    }
  }
});
If you have previously created the recipient  in Encharge, you can use personalization tags, for example {{ person.firstName }} in your email's text. See what fields you can use in Person Fields.

Transactional Email API - Previous

Send an email from template

Next - Transactional Email API

Send a plain-text email

Last updated 7 months ago