Aller au contenu principal

Receive delivery updates via webhook

You can receive updates about an event by subscribing to webhooks from the Marketplace API. Your app will need to provide an internet-accessible endpoint that will receive and process the webhooks.

Create a webhook endpoint​

Add a new internet-accessible endpoint to your app that will receive and process the webhooks. Make sure you note the endpoint's URL.

Webhook Endpoints to Create:​

  • Orders [Required] - Receive DoorDash Orders
  • Menu Status [Required] - Receive DoorDash menu status callback notification
  • Menu Request [Required] - Receive requests from DoorDash to pull menu for a location
  • Order Release- Receive notification from DoorDash to release an order from POS to kitchen
  • Order Canceled - Receive notification from DoorDash if an order is canceled
  • Dasher Status Updates - Receive notifications to provide visibility into Dasher location

As you implement your endpoint, use the API Reference to understand the events that will be sent and the fields that will be sent with each event.

Secure your webhook endpoint​

The endpoint that will receive our webhooks must be an HTTPS endpoint and should be protected with authentication token.

Configure your webhook in the Portal​

Each environment (Sandbox and Production) supports only one webhook endpoint. You must also request production access before you can configure a production webhook endpoint. Navigate to the Developer Portal and click Webhooks in the left navigation. Developer Portal - Create a Test Store

On the Webhooks page, click the ‘Configure Endpoint’ icon. Developer Portal - Create a Test Store

Configure the endpoint by inputting the provider (Sandbox or Production). The event type, the URL and the Auth Token into the subsequent fields.

Developer Portal - Create a Test Store

Click Configure Endpoint to save your webhook configuration.

Configure your webhook without the Portal​

If your team does NOT have access to the developer portal, please reach out to a DoorDash team member and provide them with the Subscription URLs and Authorization Headers/Tokens for each endpoint.