Emails

Update e-mail automation

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 / automations / {automation_id}

Changes the fields that you send. All other fields stay, the status too. To activate or deactivate, use POST /v1/email/automations/{automation_id}/status.

A new trigger counts only for contacts who start later.
On an active automation, new exit products also remove the contacts who already bought them.

Changes at once MCP tool update_email_automation

curl -X PATCH "https://api.tentary.com/v1/email/automations/852" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "After the Yoga Basics e-book"
}'

const response = await fetch("https://api.tentary.com/v1/email/automations/852", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "After the Yoga Basics e-book"
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/email/automations/852",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "name": "After the Yoga Basics e-book",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/automations/852');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'After the Yoga Basics e-book',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "id": 852,
  "name": "After the Yoga Basics e-book",
  "status": "inactive",
  "trigger": "purchase_of_products",
  "trigger_products": [
    {
      "id": 101,
      "name": "Yoga Basics E-Book"
    }
  ],
  "active_emails": 0,
  "contacts_in_automation": 0,
  "active_since": null,
  "admin_url": "https://app.tentary.com/emails/automation/view/852",
  "exit_products": [
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days"
    }
  ],
  "emails": [],
  "more_emails": false
}

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

automation_id integer required

The id from list_email_automations.

min 1 Example: 852

Body application/json

name string

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

min length 1 max length 255
trigger string

What starts the series for a contact: new_subscriber (newsletter sign-up), any_purchase, or purchase_of_products (one of trigger_product_ids). Only contacts who subscribed to the newsletter get the e-mails.

Allowed values: new_subscriberany_purchasepurchase_of_products
trigger_product_ids array of integer

For purchase_of_products: products from list_products.

min 1 max items 200
exit_product_ids array of integer

Contacts who buy one of these products leave the automation (for example the product that the series sells). [] = none.

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.
status string

The status.

Allowed values: activeinactive
trigger string can be null

What starts the series for a contact.

Allowed values: new_subscriberany_purchasepurchase_of_productsnull
trigger_products array of object

For purchase_of_products.
Show 2 fields Hide fields
- id integer
  
  The ID.
- name string can be null
  
  The name.
active_emails integer

Active e-mails in the series.
contacts_in_automation integer

Contacts in the series now.
active_since string<date-time> can be null

UTC, like 2026-01-31T14:05:00Z.
admin_url string<uri>

The page in the Tentary app.
exit_products array of object

Contacts who buy one of these products leave the automation.
Show 2 fields Hide fields
- id integer
  
  The ID.
- name string can be null
  
  The name.
emails array of object

In the order of the app page (send time).
Show 10 fields Hide fields
- id integer
  
  The ID.
- name string
  
  The name.
- subject string
  
  The subject line.
- status string
  
  The status.
  
  Allowed values: activeinactive
- send_after_days integer
  
  Days after the trigger. 0 = at once.
- send_hour_utc integer can be null
  
  Hour (UTC) of the send day. null with send_after_days 0.
- text_preview string
  
  The start of the text, without HTML.
- sent integer
  
  E-mails sent.
- delivery object
  
  E-mails per delivery state. skipped = left out by the cooldown.
  Show 6 fields Hide fields
  
  waiting integer
  
  Waiting to be sent.
  
  skipped integer
  
  Left out by the cooldown.
  
  failed integer
  
  Could not be sent.
  
  soft_bounces integer
  
  Soft bounces (a temporary problem, like a full inbox).
  
  hard_bounces integer
  
  Hard bounces (the address does not exist).
  
  spam_complaints integer
  
  Marked as spam by the recipient.
- admin_url string<uri>
  
  The page in the Tentary app.
more_emails boolean

true = the automation has more e-mails than this list (see the app).