# E-mail automations

`GET https://api.tentary.com/v1/email/automations`

Source: https://tentary.com/de/help/api/list-email-automations/
Area: E-Mails
MCP tool: `list_email_automations`. Reads only. Changes nothing in the account.

---

The email automations (series that start on a trigger), newest first: status, trigger (new subscriber, any purchase, or purchase of certain products), number of active emails, contacts in the automation now, and admin links.

Tentary has no open or click tracking. For the emails of one automation, call [`GET /v1/email/automations/{automation_id}`](https://tentary.com/de/help/api/get-email-automation/).

## Authorization

`Authorization: Bearer <API key>`

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

## Query parameters

- `status` (string, query): Only automations with this status. Allowed values: `active`, `inactive`.
- `cursor` (string, query): 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, query): Items per page, default 25. Limits: min 1, max 50.

## Response

- `automations` (array of object): Newest first.
  - `id` (integer): The ID.
  - `name` (string): Name in the Tentary app.
  - `status` (string): The status. Allowed values: `active`, `inactive`.
  - `trigger` (string, can be null): What starts the series for a contact. Allowed values: `new_subscriber`, `any_purchase`, `purchase_of_products`, `null`.
  - `trigger_products` (array of object): For purchase_of_products.
    - `id` (integer): The ID.
    - `name` (string, can be null): 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>, can be null): UTC, like 2026-01-31T14:05:00Z.
  - `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.
- `links` (object): Pages in the Tentary app or on tentary.com.
  - `automations` (string<uri>): Page in the Tentary app.

## Example request

```bash
curl "https://api.tentary.com/v1/email/automations" \
  -H "Authorization: Bearer $TENTARY_API_KEY"
```

## Example response

```json
{
  "automations": [
    {
      "id": 851,
      "name": "Welcome series",
      "status": "active",
      "trigger": "new_subscriber",
      "trigger_products": [],
      "active_emails": 1,
      "contacts_in_automation": 0,
      "active_since": "2026-08-29T10:00:00Z",
      "admin_url": "https://app.tentary.com/emails/automation/view/851"
    }
  ],
  "next_cursor": null,
  "links": {
    "automations": "https://app.tentary.com/emails/automations"
  }
}
```