---
title: "Create Assignment"
method: POST
path: "/resource-planner/assignments"
tags: ["Schedule"]
---

# Create Assignment

`POST /resource-planner/assignments`

Create a schedule assignment. To create time-off use `POST /resource-planner/assignments/time-off` instead.

## Request body

- AssignmentRequestCreateRequest
  - `user` integer
  - `project` string — Project encoded ID
  - `task` string — Task encoded ID
  - `client` integer — Client ID
  - `type` 'project' | 'client' | 'task' | 'time-off'
  - `startDate` string, required — Format: Y-m-d
  - `endDate` string, required — Format: Y-m-d
  - `time` integer — Scheduled time in seconds
  - `note` string — Max 1000 chars
  - `includeWeekends` boolean
  - `color` string — Hex color #rrggbb
  - `sendNotification` boolean
  - `forceOverride` boolean
  - `timeOffType` string — Time-off type (only when type is `time-off`).
  - `timeOffPeriod` 'full-day' | 'half-of-day' | 'quarter-of-day' | 'half-and-quarter-of-day' — Time-off period (only when type is `time-off`).
  - `status` 'pending' | 'approved' — Time-off approval status (only when type is `time-off`).
  - `users` integer[] — Create the same schedule for multiple users (create only).
  - `reviewer` integer — Reviewer user ID for time-off (create only).

## Response `200`

OK

- Assignment
  - `days` number — Number of workdays
  - `endDate` string
  - `id` number
  - `project` string
  - `startDate` string
  - `time` number — Scheduled time in seconds
  - `type` 'project' | 'time-off'
  - `user` number

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/everhour/apis/everhour-api.md) · [All operations](https://skmtc.net/everhour/apis/everhour-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everhour/everhour-api/revisions/fc6136e33352/schema)