Emails

Update 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

PATCH / v1 / email / automation-emails / {email_id}

Changes the fields that you send. All other fields stay, the status too.

The new text of an active email also applies to emails that wait to be sent.
An active email keeps its send time and needs a subject and a text.

Changes at once MCP tool update_automation_email

curl -X PATCH "https://api.tentary.com/v1/email/automation-emails/862" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "send_hour_utc": 8
}'

const response = await fetch("https://api.tentary.com/v1/email/automation-emails/862", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "send_hour_utc": 8
  }),
});
const data = await response.json();

import os
import requests

response = requests.patch(
    "https://api.tentary.com/v1/email/automation-emails/862",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "send_hour_utc": 8,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/automation-emails/862');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'send_hour_utc' => 8,
    ]),
    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": 8,
  "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

email_id integer required

The id of an e-mail from get_email_automation.

min 1 Example: 862

Body application/json

name string

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.