Skip to main content

Use Businesses & Stores by API

API: Drive (classic)

This doc covers the Drive (classic) API. If you're using the Drive API, see the how-to guide for using businesses & stores with Drive.

1. Prerequisites​

Make sure you've created an access key and generated a JWT.

2. Map your data model to DoorDash's data model​

DoorDash uses businesses to represent a legal entity or owner and stores to represent a single location that makes deliveries (learn more in the business & store reference guide). If your system has a similar two-tier data model, you can create a business for each legal entity and as many stores as needed under that entity. If your system has a one-tier data model, you can just create a business and a single store for each corresponding store in your data model. See guide here for examples of different tiered data models.

3. Create a business​

Create a business using an external identifier of your choice. We recommend using the same identifier that you use to represent the business in your own systems to make it easier to troubleshoot issues.

HTTP POST /developer/v1/businesses

{
    "external_business_id": "a0720d55-7cbe-41ce-8185-58285b7985cd",
    "name": "Neighborhood Deli",
    "description": "Neighborhood deli that has great sandwiches and coffee",
    "activation_status": "active"
}

4. Create a store​

Create a store, or as many stores as needed, under the business you created in the last step.

HTTP POST /developer/v1/businesses/{{external-business-id}}/stores

{
    "external_store_id": "ed178ef3-b486-4ce8-8baa-5bc9f0f3fa4a",
    "name": "Neighborhood Deli #10",
    "phone_number": "+12065551212",
    "address": "901 Market Street, 6th Floor, San Francisco, CA, 94103"
}

Creating a Delivery​

When you create a delivery, you must provide the external IDs of the business and the store. DoorDash will take pickup delivery details, such as pickup_address and pickup_phone_number, from the store's configuration. When you create a delivery for a store, you don't need to pass these fields in the request body.

POST /drive/v1/deliveries

{
    "external_delivery_id": "D-1763",
    // other fields

    // one of the business identifiers: external_business_id or external_business_name
    "external_business_name": "b-234-dzs",
    "external_business_id": "b-234-dzs-id",
    // store identifier 
    "external_store_id": "s-475-fnr",
}

Next steps​

Now that you know how to use businesses and stores, you can: