---
title: messages.previewTemplate | Doing Work API
description: Show how one kind of automatic customer email reads, filled with sample customer details and the shop's name. Send subject and body to preview unsaved word
url: https://doingwork.work/docs/reference/messages-previewtemplate/
---

# messages.previewTemplate

Show how one kind of automatic customer email reads, filled with sample customer details and the shop's name. Send subject and body to preview unsaved wording (checked the same way as saving); leave them out to preview the wording in use. Sends nothing.

|  |  |
|---|---|
| Who | Agents can call this |
| REST | `POST /v1/messages/templates/preview` |
| MCP tool | `messages_previewTemplate` |
| Writes | no |
| Area | [Customer hub, requests and customer emails](https://doingwork.work/docs/reference/#customer-hub-requests-and-customer-emails) |

## When to use it

The shop can set its own wording for the automatic customer emails: invoice reminders, quote follow-ups and review requests. Read messages.templates for the wording in use and the placeholders each kind takes.

## What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

## Input

| Field | Type | Required |
|---|---|---|
| `shop_id` | string (uuid) | yes |
| `kind` | string (one of invoice_reminder, quote_followup, review_request) | yes |
| `subject` | string | no |
| `body` | string | no |

## Example

```http
POST https://doingwork.work/v1/messages/templates/preview
content-type: application/json
Idempotency-Key: 3f1c...

{
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "kind": "invoice_reminder"
}
```

## Output

| Field | Type | Always there |
|---|---|---|
| `subject` | string | yes |
| `body` | string | yes |
| `from_name` | string | yes |
| `note` | string | yes |

```json
{
  "subject": "...",
  "body": "...",
  "from_name": "...",
  "note": "..."
}
```

## Errors

| Code | Status | What to do |
|---|---|---|
| `invalid_input`, `invalid_token`, `rate_limited` |  | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |