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

1. Can we leverage the same openAPI provider type as the other endpoints?

   • Yes, you will need to use the same provider type.

2. 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.

3. *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.

4. 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.

5. Do you support multiple different item promos on a single item?

   • We currently only support one promo on a single item.