---
title: "Creates a new project work schedule booking for a user over a date range with specified hours per day or total duration."
method: POST
path: "/api/ScheduleSeries/AddBooking"
tags: ["ScheduleSeries"]
---

# Creates a new project work schedule booking for a user over a date range with specified hours per day or total duration.

`POST /api/ScheduleSeries/AddBooking`

## Request body

- CreateBooking — Request model for creating a new project work schedule booking over a date range.
  - `UserIDFK` integer — The user ID to schedule the booking for.
  - `HoursPerDay` number, double — Hours to allocate per working day.
  - `TotalDuration` number, double — Total hours across the booking (alternative to HoursPerDay).
  - `DurationType` string — Possible values are "HoursPerDay" or "TotalDuration"
  - `ScheduleOnDaysOff` boolean — Whether to include weekends and holidays.
  - `ProjectIDFK` integer — The project to book time against.
  - `CategoryIDFK` integer — The timesheet category for the booking.
  - `TaskIDFK` integer — Optional task to link the booking to.
  - `Notes` string — Additional notes for the booking.
  - `StartDate` string, date-time — Start date of the booking period.
  - `EndDate` string, date-time — End date of the booking period.
  - `StartTime` string — Optional start time of day for the booking.
  - `SendWebhooks` boolean — If true, fires the scheduleseries_created webhook event to any subscribed endpoints. Defaults to false to preserve existing integration behaviour.

## Response `200`

Returns the created schedule booking with assigned Series ID.

- ScheduleSeriesDetails — A schedule series record representing a continuous booking or leave allocation for a user over a date range.
  - `ScheduleSeriesID` integer — Unique identifier for the schedule series.
  - `AccountIDFK` integer — The Avaza account this schedule belongs to.
  - `UserIDFK` integer — The user this schedule is assigned to.
  - `Firstname` string — Scheduled user's first name.
  - `Lastname` string — Scheduled user's last name.
  - `ProjectIDFK` integer — The project this booking is for (null for leave).
  - `ProjectTitle` string — Title of the associated project.
  - `CompanyIDFK` integer — The customer company of the associated project.
  - `CompanyName` string — Name of the customer company.
  - `TimeSheetCategoryIDFK` integer — The timesheet category for this booking.
  - `TimeSheetCategoryName` string — Name of the timesheet category.
  - `LeaveTypeIDFK` integer — The leave type ID (for leave schedule entries).
  - `LeaveTypeName` string — Name of the leave type.
  - `StartDate` string, date-time — Start date of the schedule series.
  - `EndDate` string, date-time — End date of the schedule series.
  - `HoursPerDay` number, double — Hours allocated per working day.
  - `TotalDuration` number, double — Total hours across the entire schedule series.
  - `ScheduleOnDaysOff` boolean — Whether to include weekends and holidays in the schedule.
  - `Notes` string — Additional notes on the schedule.
  - `TaskIDFK` integer — The task this booking is linked to, if any.
  - `TaskTitle` string — Title of the associated task.
  - `DateCreated` string, date-time — Date and time the record was created.
  - `DateUpdated` string, date-time — Date and time the record was last updated.
  - `UpdatedByUserIDFK` integer — User ID of the person who last updated this schedule.
  - `StartTime` string — Optional start time of day for the scheduled work.
  - `EndTime` string — Optional end time of day for the scheduled work.
  - `isBillable` boolean — Whether this booking is billable, based on project billing method and category settings.
  - `RateAmount` number, double — The applicable billing rate per hour for this booking.
  - `CostAmount` number, double — The applicable cost rate per hour for this booking.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)