---
title: "Create an outreach email template"
method: POST
path: "/v3/outreach/templates"
tags: ["Outreach"]
---

# Create an outreach email template

`POST /v3/outreach/templates`

Save a reusable subject and body for pitching. A draft COPIES the template when it is composed, so editing one later never rewrites mail already queued or sent. Merge variables are substituted when a draft is composed: {{first_name}}, {{contact_name}}, {{contact_role}}, {{target_site_name}}, {{prospect_domain}}, {{target_page_url}}, {{display_name}}, {{your_brand}}, {{your_domain}}. Three of these name different things that all look like 'the site': {{prospect_domain}} and {{target_site_name}} are the recipient's (identical today), {{your_domain}} is the sender's own. {{your_brand}} is the sender's brand name. {{display_name}} is the sending MAILBOX's name, not the name of whoever queued the send. Withdrawn names still resolve so older templates keep working ({{domain}}, {{site_name}}, {{source_url}}, {{name}}, {{role}}, {{your_name}}, {{matched_query}}) but must not be used in new ones - {{matched_query}} especially, since it can hold the full text of an AI prompt rather than a phrase that reads as English. Unknown variables collapse to an empty string rather than leaking braces into a real email. A team may hold at most 100 templates, and names are unique within a team.

## Request body

- object
  - `name` string, required — Internal label, unique within the team.
  - `subject` string, required — Subject line. May contain merge variables.
  - `body` string, required — Markdown body. May contain merge variables.

## Response `200`

Default Response

## Changes

- **2026-09-18** `e0163b1c37cb` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2026-09-17** `ea8bce67cd7e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/outreach/templates/post.md)

---

[API](https://skmtc.dev/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.dev/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snowseo/apis/snowseo-api/revisions/623d4784f6e6?raw)