Emails

Send e-mail campaign

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 / campaigns / {campaign_id} / send

Sends a draft campaign to its audience now, or schedules it with send_at.

The campaign needs a subject, a text, safe links and, for a product audience, products. GET /v1/email/campaigns/{campaign_id} shows problems_before_sending. Send a test with POST /v1/email/test first.

After the call: the account owner confirms at the confirm_url within 5 minutes. Then check the result with GET /v1/confirmations/{confirmation_id}.

The confirmation page shows the estimated number of recipients. After the send, GET /v1/confirmations/{confirmation_id} returns it.

Needs your confirmation MCP tool send_email_campaign

Changes nothing at once. The answer has a link that the account owner confirms in Tentary. Confirmations

curl -X POST "https://api.tentary.com/v1/email/campaigns/802/send" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "send_at": "2026-10-29T09:00:00Z"
}'

const response = await fetch("https://api.tentary.com/v1/email/campaigns/802/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "send_at": "2026-10-29T09:00:00Z"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/email/campaigns/802/send",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "send_at": "2026-10-29T09:00:00Z",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/campaigns/802/send');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'send_at' => '2026-10-29T09:00:00Z',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "status": "needs_confirmation",
  "confirmation_id": 2,
  "confirm_url": "https://app.tentary.com/ai/confirm/8LoXzDrpV3Iy0x3oq3GK4xo1toohaHXx",
  "expires_at": "2026-10-27T08:56:48Z",
  "summary": "Schedule campaign \"November newsletter\"",
  "message": "Nothing happened yet. Give the seller the confirm_url: they open it while logged in to Tentary and confirm within 5 minutes. Then call get_confirmation to see the result. If the link expired, call this tool again."
}

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

campaign_id integer required

A draft from list_email_campaigns or create_email_campaign.

min 1 Example: 802

Body application/json

send_at string

Time with a zone, like 2026-11-26T09:00:00Z. Leave out to send at once after the confirmation.

Response

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

The action waits for the seller's confirmation.

status string

Nothing happened yet.

Allowed values: needs_confirmation
confirmation_id integer

For get_confirmation.
confirm_url string<uri>

The seller opens it while logged in to Tentary and confirms.
expires_at string<date-time>

UTC, like 2026-01-31T14:05:00Z. The link works until then.
summary string

What the seller confirms.
message string

Next steps for the AI app.