---
title: "Submit a template selection"
method: POST
path: "/api/v1/template_selections"
tags: ["Template Selections"]
---

# Submit a template selection

`POST /api/v1/template_selections`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/template_selections`
- Auth: none declared. Required headers: `Api-Key`

After a customer chooses a template, this API endpoint should be called.

**Required permission:** `design_template_select`

## Headers

- `Api-Key` string, required

## Request body

- object
  - `template_selection` object
    - `event_booking_id` integer, required: Check Cherry Booking ID
    - `design_id` integer, required: Design ID
    - `user_id` integer, required: User ID
    - `template_name` string, required: Template Name
    - `template_image_url` string, required: Template Image URL
    - `account_number` string: Your Customer's Account Number
    - `template_purchase_url` string: Template Purchase URL
    - `additional_params` object: Optional personalization the customer entered (e.g. their notes or answers). Each key/value becomes a labeled customization line shown on the booking and in the "template selected" notification. Keys are humanized for display.

## Response `200`

template selection submitted

## Other responses

- `422`: validation errors

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)