Emails

E-mail automations

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

The email automations (series that start on a trigger), newest first: status, trigger (new subscriber, any purchase, or purchase of certain products), number of active emails, contacts in the automation now, and admin links.

Tentary has no open or click tracking. For the emails of one automation, call GET /v1/email/automations/{automation_id}.

Reads only MCP tool list_email_automations

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

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

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

200 · Response

{
  "automations": [
    {
      "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"
    }
  ],
  "next_cursor": null,
  "links": {
    "automations": "https://app.tentary.com/emails/automations"
  }
}

Authorization

Authorization string header required

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

Query parameters

status string

Only automations with this status.

Allowed values: activeinactive
cursor string

next_cursor of the previous page. Send the same filters and limit again: the cursor does not keep them. Leave out for the first page.
limit integer

Items per page, default 25.

min 1 max 50

Response

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

automations array of object

Newest first.
Show 9 fields Hide fields
- 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.
next_cursor string can be null

Send it as cursor for the next page, with the same filters and limit. null = this is the last page.
links object

Pages in the Tentary app or on tentary.com.
Show 1 field Hide fields
- automations string<uri>
  
  Page in the Tentary app.