> For the complete documentation index, see [llms.txt](https://docs.encharge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.encharge.io/transactional-email-api/overview.md).

# Overview

Encharge really shines when it comes to sending automated emails. However, if you need to send transactional emails (e.g. password resets), this API has got your back.

For example, you can use this API to send emails like:

* Password reset email
* Single sign-on email with a magic login link
* Payment receipt email
* and more

## Benefits

Sending HTML over email is a mess. Knowing what email clients support what HTML features can be a full-time job. 

With Encharge, you can use our Visual Drag-and-Drop editor or our Simple editor to create a standard-compliant email that will look properly in all email clients. Then, you can send the template using this API.

**Further reading:**

* [Explore more benefits](https://docs.encharge.io/transactional-email-api/features) of sending transactional email via Encharge.
* [What are transactional emails?](https://encharge.io/what-are-transactional-emails/)
* [11 Best Practices for Transactional Email Marketing](https://encharge.io/11-best-practices-for-transactional-email-marketing/)

## Getting Started 

### 0. Create an account and get your API key

If you haven't registered for Encharge yet, [create an account](https://app.encharge.io/register). Then, get your API key from [your Account](https://app.encharge.io/account/info).

### 1. Create an email template

Open the [Emails section](https://app.encharge.io/emails) in Encharge. Click the + icon in the lower-left to create a new email. You can skip this step if you've already created your email template.

### 2. Send a request to the Transactional Email API

An example follows in Node.js. You can use [API documentation in Postman](https://documenter.getpostman.com/view/460427/TVRj5o3E) to generate an example in your preferred language.

```javascript
const axios = require('axios');

// Send a POST request
axios({
  method: 'post',
  url: 'https://api.encharge.io/v1/emails/send?token=yourAPIKey',
  data: {
    "to": "recipient@acme.com",
    // Name of the template you created in step 1.
    "template": "Template Name",
    /**
   * Dictionary of properties to be replaced in the email.
   * For example, passing
   * `{ "loginURL": "https://app.encharge.io/login/3n2l3ad99"}`
   * will replace
   * `{{ loginURL }}` in the email body or subject.
   *
   */
    "templateProperties": {
      "loginURL": "https://app.encharge.io/login/3n2l3ad99"
    }
  }
});

```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.encharge.io/transactional-email-api/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.