E-Mails

Create e-mail automation

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

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

Ändert sofort MCP-Werkzeug 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 · Antwort

{
  "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
}

Autorisierung

Authorization string Header erforderlich

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

Body application/json

name string erforderlich

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

min. Länge 1 max. Länge 255
trigger string erforderlich

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.

Mögliche Werte: new_subscriberany_purchasepurchase_of_products
trigger_product_ids array of integer

For purchase_of_products: products from list_products.

min. 1 max. Einträge 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. Einträge 200

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

id integer

The ID.
name string

Name in the Tentary app.
status string

The status.

Mögliche Werte: activeinactive
trigger string kann null sein

What starts the series for a contact.

Mögliche Werte: new_subscriberany_purchasepurchase_of_productsnull
trigger_products array of object

For purchase_of_products.
2 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string kann null sein
  
  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> kann null sein

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.
2 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string kann null sein
  
  The name.
emails array of object

In the order of the app page (send time).
10 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string
  
  The name.
- subject string
  
  The subject line.
- status string
  
  The status.
  
  Mögliche Werte: activeinactive
- send_after_days integer
  
  Days after the trigger. 0 = at once.
- send_hour_utc integer kann null sein
  
  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.
  6 Felder anzeigen Felder ausblenden
  
  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).