Overview
Store Management API
Overview
The Store Management API is designed for DoorDash partners to manage the hours of operation for individual stores. It allows partners to update store availability for ordering.
Endpoint URL: https://openapi.doordash.com/marketplace/api/v2/stores/{store_location_id}
Getting Started
Request
HTTP Method:
- PATCH: Update individual store hours
Headers:
- Refer to the JWT authentication documentation for authentication details.
Payload Example: Link to Example Payload
Response
Success Response:
- The response to a successful request will be a mirror of the payload provided in the request.
Fail Response Details:
- These are the same as previous endpoints.
Verification
- Navigate to the store's Merchant Portal page and check the Store Availability section to verify changes are reflected.
FAQ
What timezone should my ‘start_time’ and ‘end_time’ be?
- The hours should be set based on the timezone of the store.
How can I send hours if my store is open overnight?
- For specific information on how to configure the store hour fields, please refer to our Hours Configuration Reference.
How can I send hours if my store is open 24/7?
- For specific information on how to configure the store hour fields, please refer to our Hours Configuration Reference.
What causes a store hours update request to fail?
- DoorDash will fail the job if store hours fall into any of the following categories:
- Overlapping Hours across multiple days.
- Start Time = End Time and times are not 00:00.
- Store Open Hours are less than 30 minutes.
- DoorDash will fail the job if store hours fall into any of the following categories:
How can I send hours if my store is closed?
- If a store is closed on a particular day (like a holiday), use Store Special Hours and set
closed = true
. - If a store is always closed on a particular day of the week, use Store Open Hours and set
start_time = 00:00
andend_time = 00:00
for thatday_index
or omit theday_index
entirely. - If a store is temporarily closed on all days, DoorDash Store Availability webhooks should be used to deactivate the store. Additional information on our Store Availability Webhooks can be found here.
- If a store is closed on a particular day (like a holiday), use Store Special Hours and set
Why is my store on DoorDash closing earlier than the hours sent?
- This is a platform-wide logic where a buffer is applied to all stores on the DoorDash site. This allows for food prep time, time for Dasher arrival, etc., before the store actually closes.
Can I set hours for a specific item?
- Yes, there is the capability to control hourly availability at an Item Level, rather than a store level. This information will be sent via our Inventory/Pricing API. Store Hours will remain the default availability if Item Hours are not defined. More details can be found here.