---
title: "Create Booking"
method: POST
path: "/api/v2/resource_management/bookings"
tags: ["Booking"]
---

# Create Booking

`POST /api/v2/resource_management/bookings`

Create a new Booking

## Headers

- `Authorization` string, required

## Request body

- BookingSchema
  - `createdAt` integer, nullable — Created timestamp for the booking
  - `updatedBy` string, nullable — User who updated the booking
  - `isArchived` boolean, nullable — A flag indicating if booking is archived
  - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
  - `extData` ExtBooking
    - `creatorEmail` string, required — Email of the creator of the booking
    - `createdAt` integer, required — Creation timestamp for the booking
    - `bookingId` integer, nullable — Internal booking ID
    - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
    - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
    - `bookedCapacity` ExtBookingCapacityData
      - `unit` 'hours' | 'percentage' | 'fraction', required — Unit of capacity. Possible values: ['hours', 'percentage', 'fraction']
      - `timeGranularity` 'daily' | 'weekly' | 'monthly', nullable — Time granularity of capacity. Possible values: ['daily', 'weekly', 'monthly']
      - `capacity` number, float, required — Capacity value
    - `lastModifiedAt` integer, nullable — Last modified timestamp for the booking
    - `endDate` integer — [DEPRECATED] End date of the booking in epoch timestamp format. Use endDateIso instead.
    - `lastModifierEmail` string, nullable — Email of the last modifier of the booking
    - `extBookingId` string, required — External booking id
    - `startDate` integer — [DEPRECATED] Start date of the booking in epoch timestamp format. Use startDateIso instead.
    - `extDemandId` string, nullable — External demand id for the demand associated with the booking
    - `employeeId` string, required — Employee id
    - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
    - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
  - `capacity` number, float, required — Booked capacity of employee
  - `startDate` integer — [DEPRECATED] Start date of the booking. Use startDateIso instead.
  - `archivedAt` integer, nullable — Archived timestamp for the booking
  - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
  - `bookingId` integer, nullable — Booking id
  - `demandId` integer, nullable — Demand id associated with the booking
  - `endDate` integer — [DEPRECATED] End date of the booking. Use endDateIso instead.
  - `updatedAt` integer, nullable — Updated timestamp for the booking
  - `employeeProfileId` integer, nullable — Profile ID of the employee
  - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
  - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
  - `createdBy` string, nullable — User who created the booking
  - `employeeEmail` string, required — Email of employee

## Response `200`

OK

- BookingSchema
  - `createdAt` integer, nullable — Created timestamp for the booking
  - `updatedBy` string, nullable — User who updated the booking
  - `isArchived` boolean, nullable — A flag indicating if booking is archived
  - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
  - `extData` ExtBooking
    - `creatorEmail` string, required — Email of the creator of the booking
    - `createdAt` integer, required — Creation timestamp for the booking
    - `bookingId` integer, nullable — Internal booking ID
    - `startDateIso` string — Start date of the booking in ISO format (YYYY-MM-DD)
    - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
    - `bookedCapacity` ExtBookingCapacityData
      - `unit` 'hours' | 'percentage' | 'fraction', required — Unit of capacity. Possible values: ['hours', 'percentage', 'fraction']
      - `timeGranularity` 'daily' | 'weekly' | 'monthly', nullable — Time granularity of capacity. Possible values: ['daily', 'weekly', 'monthly']
      - `capacity` number, float, required — Capacity value
    - `lastModifiedAt` integer, nullable — Last modified timestamp for the booking
    - `endDate` integer — [DEPRECATED] End date of the booking in epoch timestamp format. Use endDateIso instead.
    - `lastModifierEmail` string, nullable — Email of the last modifier of the booking
    - `extBookingId` string, required — External booking id
    - `startDate` integer — [DEPRECATED] Start date of the booking in epoch timestamp format. Use startDateIso instead.
    - `extDemandId` string, nullable — External demand id for the demand associated with the booking
    - `employeeId` string, required — Employee id
    - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
    - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
  - `capacity` number, float, required — Booked capacity of employee
  - `startDate` integer — [DEPRECATED] Start date of the booking. Use startDateIso instead.
  - `archivedAt` integer, nullable — Archived timestamp for the booking
  - `bookingStatus` 'pending' | 'approved' | 'rejected', required — Status of the booking. Possible values: ['pending', 'approved', 'rejected']
  - `bookingId` integer, nullable — Booking id
  - `demandId` integer, nullable — Demand id associated with the booking
  - `endDate` integer — [DEPRECATED] End date of the booking. Use endDateIso instead.
  - `updatedAt` integer, nullable — Updated timestamp for the booking
  - `employeeProfileId` integer, nullable — Profile ID of the employee
  - `bookingType` 'demand' | 'leave' | 'optional_holiday' | 'blocker', required — Type of the booking. Possible values: ['demand', 'leave', 'optional_holiday', 'blocker']
  - `endDateIso` string — End date of the booking in ISO format (YYYY-MM-DD)
  - `createdBy` string, nullable — User who created the booking
  - `employeeEmail` string, required — Email of employee

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)