---
title: "Prepare a fixed-template Tally email without sending"
method: POST
path: "/admin/tally-emails"
tags: ["Administration"]
---

# Prepare a fixed-template Tally email without sending

`POST /admin/tally-emails`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/admin/tally-emails`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Requires admin:tally-email:write. Saves an immutable actor-owned preview. No sender, reply-to, signature, raw HTML, or arbitrary attachment overrides. Uses Tally <tally@ledgerhq.ai> and replies to tally@ledgerhq.ai.

## Request body

- object
  - `to` string[], required
  - `cc` string[]
  - `bcc` string[]
  - `subject` string, required
  - `body` string, required: Plain text, no signature; HTML is escaped.
  - `screenshots` object[]
    - `filename` string, required
    - `caption` string, required
    - `content` string, byte, required

## Response `200`

Saved preview with draftId, digest, fixed from/reply_to, recipients, HTML, text, previewHtml, and screenshot metadata; GET also returns receipt and deliveryStatus.

## Other responses

- `403`: Site-admin or scoped admin-agent access required.

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)