Skip to main content

Get started (Postman)

This tutorial will introduce you to the Drive API, DoorDash's API for requesting deliveries fulfilled by our fleet of Dashers, using the Postman API development tool. It assumes you're familiar with the basics of Postman. If you'd like to learn the Drive APIs by writing code, you should use the Get started (Node.js SDK) tutorial or Get started (API) tutorial instead.

API: Drive

This doc covers the Drive API. If you're an existing customer using the Drive (classic) API, see the tutorial for getting started with the Drive (classic) APIs.

Want to jump right in?

If you're already familiar with how to use Postman, you can jump right in:

Table of contentsโ€‹

  1. Sign into the Developer Portal
  2. Create an access key
  3. Set up Postman
  4. Create a delivery
  5. Use the Delivery Simulator
  6. Get the status of your delivery
  7. Finish up

1. Sign into the Developer Portalโ€‹

Go to the Developer Portal using the link in the top right corner of this page. If you already have a DoorDash account, enter your email and password and sign in; if not, or if you want to use a different account for development, click Sign Up and follow the process to create an account.

A screenshot of the Developer Portal sign-in screen

2. Create an access keyโ€‹

In the left navigation, click Credentials.

A screenshot of the Developer Portal left navigation menu with the Credentials navigation item highlighted

On the Credentials page, click the plus (+) icon in the center of the page to create a new access key. You'll use this access key to create a JSON Web Token (JWT) that you can use to make requests to the Drive API.

A screenshot of the Credentials page with the button for creating a new access key highlighted

Name your key test-app and click Create Access Key.

A screenshot of the modal for creating an access key

Click Copy to copy the access key to your clipboard and then paste it somewhere where you can access it later in the tutorial.

A screenshot of an access key

3. Set up Postmanโ€‹

First, click the button below to fork the DoorDash Drive Postman collection:

You may need to sign up for Postman if you don't have an account.

3.1. Set up a Postman environmentโ€‹

Once you have the fork of the collection, set up an Environment to store your access key.

  1. In the left sidebar, click Environments, then click the โž• symbol.
  2. Name your environment "Drive sandbox".
  3. Add two default variables called "developer_id" and "key_id", and two secret variables called "signing_secret" and "JWT" (note the capitalization) and paste in each of the values from your Access Key. Leave "JWT" blank.
A screenshot of the Postman environment screen

In the upper right, next to the eyeball, click the dropdown and select the "Drive sandbox" environment you just created.

A screenshot of the Postman environment picker

4. Create a deliveryโ€‹

Now you can create a delivery by making a request to the Drive API using Postman.

tip

When you created your access key, you created it for the Sandbox environment (until you request production access, you can only create access keys for the Sandbox environment). Because you're using an access key for the Sandbox environment, you can experiment with the API as much as you like without incurring real costs or hailing real Dashers.

In the left sidebar, click Collections, then expand the Drive collection that you forked and click the Create a Delivery request. Click the Body tab to see the request that will be sent.

A screenshot of the Postman request screen

Click Send to create the delivery.

5. Use the Delivery Simulatorโ€‹

You can use the Delivery Simulator to advance your delivery through the stages of the delivery process, from creation to Dasher assignment to pickup to delivery.

In the Developer Portal left navigation, click Simulator.

A screenshot of the Developer Portal left navigation menu with the Simulator navigation item highlighted

Find the delivery you created by looking for the identifier #D-12345. Click Advance to Next Step to move your delivery to the Delivery Confirmed stage.

A screenshot of the Delivery Simulator with a delivery in the Delivery Created stage

6. Get the status of your deliveryโ€‹

You can always get the latest status of a delivery by making a request to the Drive API.

In the left sidebar, click the Get Delivery Status request. Ensure that the URL of the request contains the delivery ID you want to get then click Send.

A screenshot of the Postman request screen

Finish upโ€‹

If you'd like, continue to use the Delivery Simulator to advance your delivery through the stages of the delivery process and then re-run the Get Delivery Status request to see how the delivery details change.

Next stepsโ€‹

Now that you're familiar with the Drive API, you're ready to start adding delivery capabilities to your app! If you'd like to follow a tutorial that will teach you how to use the Drive APIs in code, use Get started (Node.js SDK) tutorial or Get started (API) tutorial. Or, to learn more, use the "How-to guides" section in the navigation on the left side of this page and the How to Build for Restaurants guide.