Emails

Create e-mail campaign

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

POST / v1 / email / campaigns

Writes a newsletter (an email to subscribers, sent once) as a draft. It sends nothing.

The account owner checks the draft at admin_url.
POST /v1/email/test sends a test to the account owner.
POST /v1/email/campaigns/{campaign_id}/send sends or schedules it after the account owner confirms.

The answer is the campaign, as in GET /v1/email/campaigns/{campaign_id}.

Changes at once MCP tool create_email_campaign

curl -X POST "https://api.tentary.com/v1/email/campaigns" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "November newsletter",
  "subject": "Yoga for runners is here",
  "body_html": "<p>Hi %FIRST_NAME%,</p><p>my new course helps you recover after every run.</p><p><a class=\"button\" href=\"https://lena-yoga.mytentary.com/p/morning-yoga\">See the course</a></p>"
}'

const response = await fetch("https://api.tentary.com/v1/email/campaigns", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "November newsletter",
    "subject": "Yoga for runners is here",
    "body_html": "<p>Hi %FIRST_NAME%,</p><p>my new course helps you recover after every run.</p><p><a class=\"button\" href=\"https://lena-yoga.mytentary.com/p/morning-yoga\">See the course</a></p>"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/email/campaigns",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "name": "November newsletter",
        "subject": "Yoga for runners is here",
        "body_html": "<p>Hi %FIRST_NAME%,</p><p>my new course helps you recover after every run.</p><p><a class=\"button\" href=\"https://lena-yoga.mytentary.com/p/morning-yoga\">See the course</a></p>",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/campaigns');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'November newsletter',
        'subject' => 'Yoga for runners is here',
        'body_html' => '<p>Hi %FIRST_NAME%,</p><p>my new course helps you recover after every run.</p><p><a class="button" href="https://lena-yoga.mytentary.com/p/morning-yoga">See the course</a></p>',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "id": 802,
  "name": "November newsletter",
  "subject": "Yoga for runners is here",
  "body_html": "<p>Hi %FIRST_NAME%,</p><p>my new course helps you recover after every run.</p><p><a class=\"button\" href=\"https://lena-yoga.mytentary.com/p/morning-yoga\">See the course</a></p>",
  "audience": "all_subscribers",
  "product_ids": [],
  "status": "draft",
  "send_at": null,
  "problems_before_sending": [],
  "admin_url": "https://app.tentary.com/emails/campaign/edit/802"
}

Authorization

Authorization string header required

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Introduction

Body application/json

name string required

Name in the Tentary app (subscribers do not see it).

min length 1 max length 255
subject string

The subject line. Takes %FIRST_NAME%, %FULL_NAME% and %EMAIL%.

max length 255
body_html string

The text as HTML: p, br, h1-h3, strong, em, u, del, ul, ol, li, blockquote, a (class "button" makes a button), img with a https src (the image_url from finish_image), span; style only color and background-color. Takes %FIRST_NAME%, %FULL_NAME% and %EMAIL%. Only https:// links, no link shorteners. Tentary adds the seller's design, imprint and unsubscribe link: do not write them.

max length 65535
audience string

Who gets it, always only contacts who subscribed to the newsletter: all_subscribers (default), all_buyers, all_non_buyers, subscribers_who_bought or subscribers_who_did_not_buy one of product_ids.

Allowed values: all_subscribersall_buyersall_non_buyerssubscribers_who_boughtsubscribers_who_did_not_buy
product_ids array of integer

For subscribers_who_bought and subscribers_who_did_not_buy: products from list_products.

min 1 max items 200

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

id integer

The ID.
name string

Name in the Tentary app.
subject string

The subject line.
body_html string

The text as HTML.
audience string

Always only contacts who subscribed to the newsletter.

Allowed values: all_subscribersall_buyersall_non_buyerssubscribers_who_boughtsubscribers_who_did_not_buy
product_ids array of integer

For subscribers_who_bought and subscribers_who_did_not_buy.
status string

The status.

Allowed values: draftscheduledsendingsent
send_at string<date-time> can be null

UTC, like 2026-01-31T14:05:00Z. null for a draft.
problems_before_sending array of string

For a draft: what stops sending. Empty = it can be sent.
admin_url string<uri>

The page in the Tentary app.