Create Template

POST

api

templates

curl -X POST "https://api.foxreach.io/api/v1/templates" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about..."
  }'

from foxreach import FoxReach
from foxreach.types import TemplateCreate

client = FoxReach(api_key="otr_your_key")
template = client.templates.create(
    TemplateCreate(
        name="Cold Intro — SaaS",
        subject="Quick question about {{company}}",
        body="Hi {{firstName}},..."
    )
)

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const template = await client.templates.create({
    name: "Cold Intro — SaaS",
    subject: "Quick question about {{company}}",
    body: "Hi {{firstName}},..."
});

{
  "data": {
    "id": "ctm_new456",
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about...",
    "category": "email",
    "createdAt": "2025-01-15T10:00:00",
    "updatedAt": "2025-01-15T10:00:00"
  }
}

Request Body

string

required

Template name.

string

Email subject line. Supports variables and spin syntax like {{firstName}}, {{company}}.

string

required

Email body content. Supports variables and spin syntax for personalization and deliverability. A body can include <img> tags with a public src. A body that contains an image is sent as HTML even when sendAsHtml is false, because plain text cannot carry it. Uploading an image is a feature of the FoxReach app only; the API, MCP server and SDKs do not expose an upload endpoint, so host the file yourself and reference its public URL.

string

default:"email"

Template category: email or reply_macro.

curl -X POST "https://api.foxreach.io/api/v1/templates" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about..."
  }'

from foxreach import FoxReach
from foxreach.types import TemplateCreate

client = FoxReach(api_key="otr_your_key")
template = client.templates.create(
    TemplateCreate(
        name="Cold Intro — SaaS",
        subject="Quick question about {{company}}",
        body="Hi {{firstName}},..."
    )
)

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const template = await client.templates.create({
    name: "Cold Intro — SaaS",
    subject: "Quick question about {{company}}",
    body: "Hi {{firstName}},..."
});

{
  "data": {
    "id": "ctm_new456",
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about...",
    "category": "email",
    "createdAt": "2025-01-15T10:00:00",
    "updatedAt": "2025-01-15T10:00:00"
  }
}

Rate Limit

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

curl -X POST "https://api.foxreach.io/api/v1/templates" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about..."
  }'

from foxreach import FoxReach
from foxreach.types import TemplateCreate

client = FoxReach(api_key="otr_your_key")
template = client.templates.create(
    TemplateCreate(
        name="Cold Intro — SaaS",
        subject="Quick question about {{company}}",
        body="Hi {{firstName}},..."
    )
)

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const template = await client.templates.create({
    name: "Cold Intro — SaaS",
    subject: "Quick question about {{company}}",
    body: "Hi {{firstName}},..."
});

{
  "data": {
    "id": "ctm_new456",
    "name": "Follow-up Template",
    "subject": "Following up on my last email",
    "body": "Hi {{firstName}},\n\nI wanted to follow up on my previous email about...",
    "category": "email",
    "createdAt": "2025-01-15T10:00:00",
    "updatedAt": "2025-01-15T10:00:00"
  }
}

Getting started

API guides

Leads

Campaigns

Sequences

Campaign Leads

Campaign Accounts

Inbox

Email Accounts

Lead Finder

Tracking Domains

Warmup

Managed Mailboxes

Templates

Analytics

Webhooks API

Request Body

Rate Limit

​Request Body

​Rate Limit

Request Body

Rate Limit