Emails

E-mail campaigns

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

GET / v1 / email / campaigns

The email campaigns (newsletters sent once), newest first by creation, not by send time. Each has its status, send time, recipients, emails sent and delivery problems: waiting, skipped by the cooldown, failed, bounces and spam complaints. The answer also has the number of newsletter subscribers.

recipients: the audience when sending started, skipped contacts included.
emails_sent: emails that went out, bounces included. Emails in progress or removed after an unsubscribe do not count. A campaign with status sent can have emails_sent 0.
sent_at: when sending started.

Tentary has no open or click tracking. For automated email series, call GET /v1/email/automations.

Reads only MCP tool list_email_campaigns

curl "https://api.tentary.com/v1/email/campaigns?limit=1" \
  -H "Authorization: Bearer $TENTARY_API_KEY"

const response = await fetch("https://api.tentary.com/v1/email/campaigns?limit=1", {
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
  },
});
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.tentary.com/v1/email/campaigns",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    params={
        "limit": 1,
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/email/campaigns?limit=1');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Response

{
  "campaigns": [
    {
      "id": 801,
      "name": "October newsletter",
      "subject": "New: Morning Yoga in 30 Days",
      "status": "sent",
      "created_at": "2026-10-18T10:00:00Z",
      "send_at": "2026-10-19T08:00:00Z",
      "sent_at": "2026-10-19T08:00:05Z",
      "recipients": 3,
      "emails_sent": 3,
      "delivery": {
        "waiting": 0,
        "skipped": 0,
        "failed": 0,
        "soft_bounces": 1,
        "hard_bounces": 0,
        "spam_complaints": 0
      },
      "admin_url": "https://app.tentary.com/emails/campaign/view/801"
    }
  ],
  "next_cursor": null,
  "newsletter_subscribers": 3,
  "links": {
    "campaigns": "https://app.tentary.com/emails/campaigns"
  }
}

Authorization

Authorization string header required

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

Query parameters

status string

Only campaigns with this status.

Allowed values: draftscheduledsendingsent
cursor string

next_cursor of the previous page. Send the same filters and limit again: the cursor does not keep them. Leave out for the first page.
limit integer

Items per page, default 25.

min 1 max 50 Example: 1

Response

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

campaigns array of object

Newest first by creation.
Show 11 fields Hide fields
- id integer
  
  The ID.
- name string
  
  The name.
- subject string
  
  The subject line.
- status string
  
  The status.
  
  Allowed values: draftscheduledsendingsent
- created_at string<date-time> can be null
  
  UTC, like 2026-01-31T14:05:00Z.
- send_at string<date-time> can be null
  
  UTC, like 2026-01-31T14:05:00Z.
- sent_at string<date-time> can be null
  
  UTC, like 2026-01-31T14:05:00Z. When sending started.
- recipients integer can be null
  
  The audience when sending started.
- emails_sent integer can be null
  
  E-mails that went out, bounces included.
- delivery object can be null
  
  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.
next_cursor string can be null

Send it as cursor for the next page, with the same filters and limit. null = this is the last page.
newsletter_subscribers integer

Contacts who subscribed to the newsletter.
links object

Pages in the Tentary app or on tentary.com.
Show 1 field Hide fields
- campaigns string<uri>
  
  Page in the Tentary app.