---
title: "Create Task List Template"
method: POST
path: "/v2/company/{company_id}/task_list_templates"
tags: ["Task Management"]
---

# Create Task List Template

`POST /v2/company/{company_id}/task_list_templates`

## Request

- Base URL: `https://api.7shifts.com`
- URL: `https://api.7shifts.com/v2/company/{company_id}/task_list_templates`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.7shifts.com/oauth2/authorize`
    - Client credentials
    - Password
    - Token URL: `https://app.7shifts.com/oauth2/token`
  - API key in cookie `7session`

## Path parameters

- `company_id` integer, required

## Headers

- `x-api-version` string: An API version
- `x-company-guid` string, uuid

## Request body

- object
  - `title` string, required
  - `description` string
  - `recurrence` string, required: recurrence rules as defined by the RFC 5545 spec
  - `assignments` object[], required
    - `location_id` integer, required
    - `department_id` integer, nullable
    - `role_id` integer, nullable
    - `user_id` integer, nullable
  - `due` string, nullable: A date with YYYY-MM-DD format
  - `time_frame` object, nullable
    - `start` string, nullable, required: The time when this task starts
    - `end` string, required: The time when this task ends
  - `task_templates` object[], nullable
    - `uuid` string
    - `title` string, required
    - `description` string, nullable, required
    - `sort` integer, required
    - `created` string, date-time
    - `task_completion` object, nullable
      - `type` 'NUMBER' | 'TEMPERATURE' | 'PHOTO' | 'STRING' | 'WEIGHT' | 'CHECKMARK', required
      - `primitive_type` 'INTEGER' | 'DECIMAL' | 'FILE' | 'STRING' | 'BOOLEAN', required
      - `unit` 'C' | 'F' | 'KG', nullable, required
  - `status` integer

## Response `201`

Created a new task list template

- object
  - `object` 'task_list_template', required
  - `data` object, required
    - `id` integer, required
    - `company_id` integer, required
    - `uuid` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `status` integer, required
    - `due` string, nullable: A date with YYYY-MM-DD format
    - `created` string, date-time, nullable, required
    - `activated_at` string, date-time, nullable, required
    - `task_templates` object[], required
      - `uuid` string
      - `title` string, required
      - `description` string, nullable, required
      - `sort` integer, required
      - `created` string, date-time
      - `task_completion` object, nullable
        - `type` 'NUMBER' | 'TEMPERATURE' | 'PHOTO' | 'STRING' | 'WEIGHT' | 'CHECKMARK', required
        - `primitive_type` 'INTEGER' | 'DECIMAL' | 'FILE' | 'STRING' | 'BOOLEAN', required
        - `unit` 'C' | 'F' | 'KG', nullable, required
    - `assignments` object[], required
      - `location_id` integer, required
      - `department_id` integer, nullable
      - `role_id` integer, nullable
      - `user_id` integer, nullable
    - `recurrence` string, required: recurrence rules as defined by the RFC 5545 spec
    - `time_frame` object, nullable
      - `start` string, nullable, required: The time when this task starts
      - `end` string, required: The time when this task ends

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Server Error

---

[API](https://skmtc.dev/7shifts/apis/7shifts-api.md) - [All operations](https://skmtc.dev/7shifts/apis/7shifts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/7shifts/apis/7shifts-api/revisions/40e0ef40dfcd?raw)