---
title: "Create a checklist"
method: POST
path: "/api/v1/checklists"
tags: ["Checklists"]
---

# Create a checklist

`POST /api/v1/checklists`

## Request

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

Creates a new checklist on an event. When a `checklist_category_id` is supplied, the new checklist's items, view/edit flags, and name are seeded from the chosen category. When it's omitted, an empty checklist named "Checklist" is created with no items.

**Required permission:** `assigned_event_write` (when the authenticated user is assigned to the event) or `unassigned_event_write` (otherwise). If a `checklist_category_id` is supplied, the category must also be accessible to the user — admins can use any category; non-admin staff can only use categories with `allow_staff_view` enabled.

## Headers

- `Api-Key` string, required

## Request body

- object
  - `event_id` integer, required: ID of the event the checklist should be attached to
  - `checklist_category_id` integer: Optional checklist category to seed the new checklist from

## Response `200`

checklist created

---

[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)