GuidesAPI Reference
Log In
API Reference

Create Delivery Slot

Create delivery slots (previously known as Planned Delivery Windows) to represent fulfillment availability by time and day ranges.

🚧

While it is possible to create delivery slots via API, we strongly encourage you to use the Bringg User Interface (Platform) for delivery slot creation.

The Create Delivery Slot API allows you to define a team's delivery availability for specific dates and durations so you can offer customers a variety of delivery options during their shopping experience. Use this endpoint to establish slots that meet your operational requirements, factoring in considerations like delivery destination, driver availability, service level, and inventory. Note that a delivery slot is returned in responses as planned_delivery_window.

Bringg provides flexibility in defining delivery slots, enabling you to reserve slots until checkout, specify durations as narrow as 30 minutes, and display slots up to a month in advance.

To set up a weekly delivery cadence, create delivery slots for an entire organization or specific teams. Adjust this schedule using the Update Delivery Slot endpoint.

After creating the slots:

  1. Use the Create Blackout endpoint to block off time when for when your team or organization are not available, such as on holidays.
  2. Send a Get Quotes request to check availability for specific orders or display delivery slots for your customers so they can schedule a time to receive their orders.
  3. Reserve a delivery slot while the customer shops by creating an order with the Create Order (Task) endpoint. Use the reserved_until field to limit how long the slot is held. If the customer does not finalize the purchase, the order is automatically canceled at the time specified by reserved_until.
  4. After checkout, use the Update Order endpoint to add inventory items and finalize the order details.
  5. If the customer cancels their order, release the reserved slot with the Cancel Order (Task) endpoint.

Learn more about the Delivery Slot Object, including more details about parameter formatting and validations.

Response (Output) Params
Body Params
string

The delivery slot's display name.

int32

Last time to place an order that can be fulfilled in this delivery slot. Include if cutoff_day and cutoff_time are not included.

int32

The last day to place an order that can be fulfilled in this delivery slot. Counted as number of days from Monday (where Monday = 1). Include if cutoff is not included.

date

Last time to place an order that can be fulfilled in this delivery slot. Include if cutoff is not included.

date

The last date when this delivery slot occurs.

date

The first date when this delivery slot occurs.

int32

The last day this delivery slot is offered. Counted as number of days from Monday (where Monday = 1).

string

The time this time slot ends.

double

Additional fees associated with fulfilling an order in this time slot.

service_area_ids
array of int32s

Indicates the service areas that are applicable for this time slot.

service_area_ids
string

Your external system's ID for the associated service plans or SLAs.

int32

The first day this time slot is offered. Counted as the number of days from Monday (where Monday=1).

string

The time the time slot begins.

int32

Bringg's ID for a team.

string

Your external system's ID for the associated team.

Responses

Language
Response
Choose an example:
application/json