---
title: "Get Message Template"
method: GET
path: "/message-templates/{messageTemplateId}"
tags: ["Message Templates"]
---

# Get Message Template

`GET /message-templates/{messageTemplateId}`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/message-templates/{messageTemplateId}`
- Auth: HTTP bearer

Fetch a single message template by ID.

## Response `200`

OK

- MessageTemplate
  - `id` integer
  - `user_id` integer
  - `sub_account_id` integer, nullable
  - `handwriting_style_id` integer: ID of the handwriting style used in the message template
  - `font_size` integer: Font size used in the message template. Only valid for AI fonts
  - `font_color` string: Font color used in the message template.
  - `handwriting_realism` boolean: Handwriting realism level used in the message template. Only valid for AI fonts
  - `name` string
  - `content` string
  - `additional_pages` string, uri: URL to additional pages to include with the cover letter. Only valid for letter templates.
  - `skip_creative_generation` integer: Flag to skip creative generation. Set when message template is PDF file only.
  - `custom_background_url` string: URL of the custom background image for the message template. Only valid for postcard backs and the interior background of notecards and giftcards.
  - `qrcode_url` string: URL of the QR code image for the message template
  - `cc_emails` string[]: List of email addresses to be CC'd on when a QR code is scanned
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `type` 'postcard' | 'postcard6x9' | 'postcard6x11' | 'letter' | 'windowlessletter' | 'notecard' | 'giftcard' | 'magnacard': Type of the message template
  - `giftcard_brand_code` string: Brand code of the gift card
  - `giftcard_brand_image` string: Image URL of the gift card brand
  - `giftcard_amount` integer: Amount of the gift card in cents
  - `landing_page_url` string, uri: URL of the gated landing page (also known as a gating URL). Recipients must visit this page before they can redeem the gift card, letting you gate redemption behind an action such as booking a demo or completing a form. Only valid for giftcards.
  - `share_uuid` string

## Other responses

- `403`: Access token is missing or invalid
- `404`: Resource not found

## Changes

- **2026-10-01** `02de08ab2a47`: 1 warning
  - added the new `postcard6x9` enum value to the `type` response property for the response status `200`
- **2026-08-05** `670a67b234a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/message-templates/:messageTemplateId/get.md)

---

[API](https://skmtc.dev/thanks-io/apis/thanks-io-api.md) · [All operations](https://skmtc.dev/thanks-io/apis/thanks-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thanks-io/apis/thanks-io-api/revisions/c403fbf3dc0f?raw)