> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a Delivery

A **Delivery** is the central object in the Dora API. It represents a single order that needs to be picked up from one location and dropped off at another.

### Video Guide: Creating a Delivery

This video walks you through the entire delivery creation workflow, including filling out required fields and setting up optional parameters like scheduling and payment methods.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/ZPSYZ72IlHU?start=26" title="Dora API Guide: Delivery Creation Tutorial" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

### The Delivery Lifecycle

A delivery moves through several statuses:

1. **`pending`**: The delivery has been created but is not assigned to a rider.
2. **`awaiting-pickup`**: The delivery has been assigned to the rider they are yet to pickup the package.
3. **`in-transit`**: The rider has picked up the package.
4. **`delivered`**: The rider has dropped off the package and confirmed delivery.
5. **`declined`**: The rider has declined the the assignment.
6. **`cancelled`**: The delivery was cancelled.

### Next Steps: Full API Details

The complete list of parameters, request bodies, and error codes is available in the API Reference.

* **View API Endpoint:** **[Manage Deliveries: Create Delivery](/api-reference/endpoints/deliveries/create-delivery)**