Emails

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

GET / v1 / email / campaigns / {campaign_id}

One campaign with its subject, full text (HTML), audience and status.

For a draft, problems_before_sending lists what stops sending, in the Tentary app and with POST /v1/email/campaigns/{campaign_id}/send.

The fields have the same names as in PATCH /v1/email/campaigns/{campaign_id}.

Reads only MCP tool get_email_campaign

curl "https://api.tentary.com/v1/email/campaigns/801" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/email/campaigns/801", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/email/campaigns/801",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/campaigns/801');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "id": 801,
  "name": "October newsletter",
  "subject": "New: Morning Yoga in 30 Days",
  "body_html": "<p>Hi %FIRST_NAME%, my new course is live.</p>",
  "audience": "all_subscribers",
  "product_ids": [],
  "status": "sent",
  "send_at": "2026-10-19T08:00:00Z",
  "problems_before_sending": [],
  "admin_url": "https://app.tentary.com/emails/campaign/view/801"
}

Authorization

Authorization string header required

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

Path parameters

campaign_id integer required

The id from list_email_campaigns.

min 1 Example: 801

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.