Overview
Promotion Management API​
Overview​
The Promotion Management API is designed for DoorDash partners to manage item level promotions they offer on the platform. It allows partners to add and update promotions for existing items at the store level.
Endpoint URL: https://openapi.doordash.com/marketplace/api/v2/promotions/stores/{store_location_id}
Getting Started​
Request​
HTTP Method:
- POST: Create new promotion for store
- PATCH: Update promotions in store
Headers:
- Refer to the JWT authentication documentation for authentication details.
Payload Example: View Example JSON
Response​
- Success Response:
{
"operation_id": "string",
"operation_status": "SUCCESS"
"message": "string"
}
- Fail Response Details:
| Response Code | Code | Message | field_errors.field | field_errors.error |
|---|---|---|---|---|
| 400 | validation_error | One or more request values couldn't be validated. | Name of the field whose value couldn't be validated. | The error that was encountered when validating the field's value. |
| 401 | authentication_error | Default: The [exp] is in the past; the JWT is expired | - | - |
| 403 | authorization_error | Default: Authorization error: the credentials provided with the request don't work | - | - |
| 404 | unknown_business_id | - | - | - |
| 422 | request_rate_limited | - | - | - |
| 429 | request_rate_limited | - | - | - |
| 500 | service_fault | Default: Internal service failure, please try again later. | - | - |
Verification:​
Once you believe you have made a successful call to the endpoint, reach out to your DoorDash technical account manager to verify. Please provide an example of the payload used in the request.
FAQ​
Can we leverage the same openAPI provider type as the other endpoints?
- Yes, you will need to use the same provider type.
How long will it take for a new promotion to be created and updated?
- Creating and updating an existing promotion may take up to 30 minutes.
*What will happen if we PATCH a promotion that doesn't exist? **
- If you send the request in the correct format, we will return a 202 Accepted response but drop the promotion during the async validation process. We plan on sharing additional feedback in the future.
How do I remove a promotion that is no longer running intra-day?
- You can remove the promotion by sharing with us a PATCH request.
Do you support multiple different item promos on a single item?
- We currently only support one promo on a single item.