> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lettr.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Templates
> List, get, create, update, and delete Lettr-managed email templates using the client.templates resource in the Node.js SDK.
The `client.templates` resource manages Lettr-managed templates. To *send* a template, see [Sending Emails → Send with a Template](/quickstart/nodejs/sending-emails#send-with-a-template).
## List Templates
```typescript theme={null}
const { data, error } = await client.templates.list({ project_id: 123, per_page: 20 });
if (!error) {
for (const template of data.templates) {
console.log(template.name, template.slug);
}
}
```
GET /templates
## Get a Template
```typescript theme={null}
const { data, error } = await client.templates.get("welcome-email");
// with a specific project:
await client.templates.get("welcome-email", 123);
if (!error) {
console.log(data.html);
console.log(data.active_version);
}
```
## Create a Template
Provide `html` **or** `json` (the TOPOL.io editor format), not both:
```typescript theme={null}
const { data, error } = await client.templates.create({
name: "My Template",
html: "...",
project_id: 123, // optional
folder_id: 5, // optional
});
if (!error) {
console.log(data.id, data.slug, data.active_version);
}
```
POST /templates
## Update & Delete
```typescript theme={null}
await client.templates.update("my-template", { name: "Renamed" });
await client.templates.delete("my-template");
await client.templates.delete("my-template", 123); // within a project
```
## Get Merge Tags
Retrieve the variables a template expects — useful for validating data before sending:
```typescript theme={null}
const { data, error } = await client.templates.getMergeTags("welcome-email", {
project_id: 123, // optional
version: 2, // optional
});
if (!error) {
for (const tag of data.merge_tags) {
console.log(tag.key, tag.required, tag.type);
}
}
```
GET /templates/{slug}/merge-tags
## What's Next
Merge tag syntax, conditionals, loops
Pull and sync templates locally