--- 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. 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 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. ## 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/). |