---
title: "Create a single delivery window"
method: POST
path: "/v1/delivery-window"
tags: ["Delivery Windows"]
---

# Create a single delivery window

`POST /v1/delivery-window`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/delivery-window`
- Auth: none declared

Create a delivery window defining an available time slot for scheduled deliveries. Delivery windows are associated with a store location and have capacity limits.

## Request body

- CreateDeliveryWindowInputSerializer: Expected payload for creating a delivery window.
  - `startTime` string, nullable: The start time of the delivery window.
  - `startTimeLocal` string, nullable: The start time of the delivery window in local timezone.
  - `endTime` string, nullable: The end time of the delivery window.
  - `endTimeLocal` string, nullable: The end time of the delivery window in local timezone.
  - `cutoffTime` string, nullable: The cutoff time of the delivery window.
  - `cutoffTimeLocal` string, nullable: The cutoff time of the delivery window in local timezone.
  - `timezoneId` string, nullable: The timezone id of the delivery window.
  - `name` string, nullable: The name of the delivery window.
  - `rrule` string, nullable: The rrule of the delivery window.
  - `exceptionDates` string[], nullable: The exception dates of the delivery window.
  - `allowedTags` string[], nullable: The allowed tags of the delivery window.
  - `leadTimeMinutes` integer, nullable: The lead time of the delivery window.
  - `priceCents` integer, nullable: The price of the delivery window.
  - `minimumOrderValueCents` integer, nullable: The minimum order value of the delivery window.
  - `maximumCapacity` integer, nullable: The maximum capacity of the delivery window.
  - `storeLocationId` string, nullable: The store location id of the delivery window.
  - `zoneId` string, nullable: The zone id of the delivery window.
  - `zoneExternalId` string, nullable: The external zone id of the delivery window.
  - `windowMetadata` object, nullable: The metadata of the delivery window.
  - `isActive` boolean, nullable: Whether the delivery window is active.
  - `isDeleted` boolean, nullable: Whether the delivery window is deleted.

## Response `200`

OK

- DeliveryWindowOutput: Response for a delivery window.
  - `id` string, required: The ID of the delivery window.
  - `name` string, required: The name of the delivery window.
  - `startTime` string, required: The start time of the delivery window.
  - `startTimeLocal` string, required: The start time of the delivery window in local timezone.
  - `endTime` string, required: The end time of the delivery window.
  - `endTimeLocal` string, required: The end time of the delivery window in local timezone.
  - `timezoneId` string, required: The timezone id of the delivery window.
  - `cutoffTime` string, required: The cutoff time of the delivery window.
  - `cutoffTimeLocal` string, required: The cutoff time of the delivery window in local timezone.
  - `rrule` string, required: The rrule of the delivery window.
  - `exceptionDates` string[], required: The exception dates of the delivery window.
  - `allowedTags` string[], required: The allowed tags of the delivery window.
  - `leadTimeMinutes` integer, required: The lead time of the delivery window.
  - `priceCents` integer, required: The price of the delivery window.
  - `minimumOrderValueCents` integer, required: The minimum order value of the delivery window.
  - `maximumCapacity` integer, required: The maximum capacity of the delivery window.
  - `storeLocationId` string, required: The store location id of the delivery window.
  - `zoneId` string, required: The zone id of the delivery window.
  - `zoneExternalId` string, required: The external zone id of the delivery window.
  - `windowMetadata` object, required: The metadata of the delivery window.
  - `isActive` boolean, required: Whether the delivery window is active.
  - `isDeleted` boolean, required: Whether the delivery window is deleted.

## Other responses

- `422`: Unprocessable Content

---

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