Emails

Create 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

POST / v1 / email / automations

Creates an automation (a series of emails that starts on a trigger). It is inactive and sends nothing yet.

Add its emails with POST /v1/email/automations/{automation_id}/emails.
Activate the automation with POST /v1/email/automations/{automation_id}/status.
Activate each email with POST /v1/email/automation-emails/{email_id}/status.

Both activations need the confirmation of the account owner. The answer is the automation, as in GET /v1/email/automations/{automation_id}.

Changes at once MCP tool create_email_automation

curl -X POST "https://api.tentary.com/v1/email/automations" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "After the e-book",
  "trigger": "purchase_of_products",
  "trigger_product_ids": [
    101
  ],
  "exit_product_ids": [
    102
  ]
}'

const response = await fetch("https://api.tentary.com/v1/email/automations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "After the e-book",
    "trigger": "purchase_of_products",
    "trigger_product_ids": [
      101
    ],
    "exit_product_ids": [
      102
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/email/automations",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "name": "After the e-book",
        "trigger": "purchase_of_products",
        "trigger_product_ids": [
            101,
        ],
        "exit_product_ids": [
            102,
        ],
    },
)
data = response.json()

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

200 · Response

{
  "id": 852,
  "name": "After the 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

Body application/json

name string required

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

min length 1 max length 255
trigger string required

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