Emails

Update 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

PATCH / v1 / email / campaigns / {campaign_id}

Changes the fields that you send of a draft campaign. All other fields stay.

Scheduled and sent campaigns cannot change.

Changes at once MCP tool update_email_campaign

curl -X PATCH "https://api.tentary.com/v1/email/campaigns/802" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "audience": "subscribers_who_did_not_buy",
  "product_ids": [
    102
  ]
}'

const response = await fetch("https://api.tentary.com/v1/email/campaigns/802", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "audience": "subscribers_who_did_not_buy",
    "product_ids": [
      102
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/email/campaigns/802",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "audience": "subscribers_who_did_not_buy",
        "product_ids": [
            102,
        ],
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/campaigns/802');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'audience' => 'subscribers_who_did_not_buy',
        'product_ids' => [
            102,
        ],
    ]),
    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": "subscribers_who_did_not_buy",
  "product_ids": [
    102
  ],
  "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

Path parameters

campaign_id integer required

The id from list_email_campaigns.

min 1 Example: 802

Body application/json

name string

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.