---
title: "Create"
method: GET
path: "/build/image-template"
tags: ["Dynamic Images"]
---

# Create

`GET /build/image-template`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/build/image-template`
- Auth: HTTP bearer

Build image for the front of your postcard or notecard.  Includes ability to set dynmiac fields and QR code.  This does not create an order, it simply builds the image and returns a URL to the image.  You can then use this image URL in your order creation request.

 ## Dynamic Data Tags

Use these tags in your header, sub-header, background image URL, and QR Code/Redirect URL to have recipient data automatically added further personalizing each postcard.
- `~FULL_NAME~`
- `~FIRST_NAME~`
- `~COMPANY~`
- `~ADDRESS~`
- `~ADDRESS2~`
- `~CITY~`
- `~STATE~`
- `~ZIP~`
- `~EMAIL~`
- `~PHONE~`
- `~CUSTOM1~`
- `~CUSTOM2~`
- `~CUSTOM3~`
- `~CUSTOM4~`
- `~YOUR_FULL_NAME~`
- `~YOUR_FIRST_NAME~`
- `~YOUR_COMPANY~`
- `~YOUR_EMAIL~`
- `~YOUR_PHONE~`

## Query parameters

- `id` integer, required
- `background_url` string
- `header` string
- `subheader` string
- `redirect_url` string
- `logo_url` string
- `overlay_url` string
- `size` '4x6' | '6x9'

## Response `200`

Successful Response

## Changes

- **2026-10-01** `02de08ab2a47`: 1 info
  - added the new optional `query` request parameter `size`

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/build/image-template/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)