---
title: "Record a template use"
method: POST
path: "/v1/templates/{id}/use"
tags: ["Templates"]
---

# Record a template use

`POST /v1/templates/{id}/use`

## Request

- Base URL: `https://app.getdealboard.com`
- URL: `https://app.getdealboard.com/v1/templates/{id}/use`
- Auth: HTTP bearer

Log one use of an email template — bumps `use_count` (the picker's most-used ordering) and appends a use record, exactly like picking it inside Dealboard. Fired by the Gmail extension after inserting a template into a draft. Optional body links the use to a deal or lead.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `deal_id` string, uuid, nullable
  - `lead_id` string, uuid, nullable

## Response `200`

OK

- object
  - `ok` boolean, required

## Other responses

- `401`: Missing or invalid credential.
- `404`: Template not found in your workspace.

---

[API](https://skmtc.dev/getdealboard/apis/dealboard-api.md) · [All operations](https://skmtc.dev/getdealboard/apis/dealboard-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getdealboard/apis/dealboard-api/revisions/4066bf9d265e?raw)