Emails

Create automation e-mail

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

Adds an email to an automation. It is inactive and reaches nobody until it is activated with POST /v1/email/automation-emails/{email_id}/status, which needs the confirmation of the account owner.

The app shows the emails in the order of their send time. The answer is the email, as in GET /v1/email/automation-emails/{email_id}.

Changes at once MCP tool create_automation_email

curl -X POST "https://api.tentary.com/v1/email/automations/852/emails" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Day 3",
  "subject": "How is your practice, %FIRST_NAME%?",
  "body_html": "<p>Three days in: which pose feels best so far?</p>",
  "send_after_days": 3,
  "send_hour_utc": 7
}'

const response = await fetch("https://api.tentary.com/v1/email/automations/852/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Day 3",
    "subject": "How is your practice, %FIRST_NAME%?",
    "body_html": "<p>Three days in: which pose feels best so far?</p>",
    "send_after_days": 3,
    "send_hour_utc": 7
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/email/automations/852/emails",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "name": "Day 3",
        "subject": "How is your practice, %FIRST_NAME%?",
        "body_html": "<p>Three days in: which pose feels best so far?</p>",
        "send_after_days": 3,
        "send_hour_utc": 7,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/automations/852/emails');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'Day 3',
        'subject' => 'How is your practice, %FIRST_NAME%?',
        'body_html' => '<p>Three days in: which pose feels best so far?</p>',
        'send_after_days' => 3,
        'send_hour_utc' => 7,
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "id": 862,
  "automation_id": 852,
  "name": "Day 3",
  "subject": "How is your practice, %FIRST_NAME%?",
  "body_html": "<p>Three days in: which pose feels best so far?</p>",
  "status": "inactive",
  "send_after_days": 3,
  "send_hour_utc": 7,
  "admin_url": "https://app.tentary.com/emails/automation/edit/852/step/edit/862"
}

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 or create_email_automation.

min 1 Example: 852

Body application/json

name string required

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

min length 1 max length 255
subject string

The subject line. Takes %FIRST_NAME%, %FULL_NAME% and %EMAIL%.

max length 255
body_html string

The text as HTML: p, br, h1-h3, strong, em, u, del, ul, ol, li, blockquote, a (class "button" makes a button), img with a https src (the image_url from finish_image), span; style only color and background-color. Takes %FIRST_NAME%, %FULL_NAME% and %EMAIL%. Only https:// links, no link shorteners. Tentary adds the seller's design, imprint and unsubscribe link: do not write them.

max length 65535
send_after_days integer

Days after the trigger. 0 = at once (default).

min 0 max 3650
send_hour_utc integer can be null

With send_after_days 1 or more: the hour (UTC) of that day, default 14. Convert from the seller's time zone (get_account_overview).

min 0 max 23

Response

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

id integer

The ID.
automation_id integer

The automation ID.
name string

The name.
subject string

The subject line.
body_html string

The text as HTML.
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.
admin_url string<uri>

The page in the Tentary app.