Emails

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

GET / v1 / email / automations / {automation_id}

One automation with its emails, in the order of the app page. Each email has:

subject and status
delay: days after the trigger and the send hour in UTC. 0 days means at once.
a short text preview
the number sent and delivery problems

The answer also lists the exit products: contacts who buy one of them leave the automation.

For the full text of an email, call GET /v1/email/automation-emails/{email_id}.

Reads only MCP tool get_email_automation

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

const response = await fetch("https://api.tentary.com/v1/email/automations/851", {
  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/automations/851",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/automations/851');
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": 851,
  "name": "Welcome series",
  "status": "active",
  "trigger": "new_subscriber",
  "trigger_products": [],
  "active_emails": 1,
  "contacts_in_automation": 0,
  "active_since": "2026-08-29T10:00:00Z",
  "admin_url": "https://app.tentary.com/emails/automation/view/851",
  "exit_products": [
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days"
    }
  ],
  "emails": [
    {
      "id": 861,
      "name": "Day 1",
      "subject": "Welcome, %FIRST_NAME%!",
      "status": "active",
      "send_after_days": 0,
      "send_hour_utc": null,
      "text_preview": "Thank you for joining. Here is my favourite morning routine.",
      "sent": 0,
      "delivery": {
        "waiting": 0,
        "skipped": 0,
        "failed": 0,
        "soft_bounces": 0,
        "hard_bounces": 0,
        "spam_complaints": 0
      },
      "admin_url": "https://app.tentary.com/emails/automation/edit/851/step/edit/861"
    }
  ],
  "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: 851

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).