> ## 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.
# Create Delivery
### 📝 Summary
This endpoint allows users to create a new delivery request in the system. It accepts details such as sender and recipient information, delivery address, package details, and delivery preferences. Upon successful creation, it returns a unique delivery ID and the status of the delivery request.
***
### Requests
##### Example
```json theme={null}
{
"creation_date": "2025-08-28",
"delivery_fee": 0,
"iam_sender": true,
"riderid": "2ce7ff7a-2c76-4e18-b681-41121ef48631",
"send_sms": true,
"sender_address": "85 Allen Avenue, Ikeja, Lagos, Nigeria",
"sender_email": "devs@venco.co",
"sender_name": "Takasuki",
"sender_phone": "8131013478",
"sender_phonecode": "234",
"receivers": [
{
"customer_address": "Penthouse - DC, Demo Estate, 404, Not Found Road, Lagos, Nigeria",
"customer_name": "Victor Maduforo",
"customer_phone_number": "8131013478",
"customer_phone_code": "234",
"item_type": "manual",
"items": [
{
"item_description": "Midea 463L Top Mount Direct Cool Refrigerator - SBS (MDRT645MTU46)",
"item_quantity": 1,
"item_value": 30
}
]
}
]
}
```
##### Params
**Description:**
| Name | Location | Type | Required | Description |
| ----------------------- | -------- | --------- | -------- | ----------- |
| `body` | body | object | no | none |
| `creation_date` | body | string | yes | none |
| `delivery_fee` | body | integer | yes | none |
| `iam_sender` | body | boolean | yes | none |
| `riderid` | body | string | yes | none |
| `send_sms` | body | boolean | yes | none |
| `sender_address` | body | string | yes | none |
| `sender_email` | body | string | yes | none |
| `sender_name` | body | string | yes | none |
| `sender_phone` | body | string | yes | none |
| `sender_phonecode` | body | string | yes | none |
| `receivers` | body | \[object] | yes | none |
| `customer_address` | body | string | no | none |
| `customer_name` | body | string | no | none |
| `customer_phone_number` | body | string | no | none |
| `customer_phone_code` | body | string | no | none |
| `item_type` | body | string | no | none |
| `items` | body | \[object] | no | none |
| `item_description` | body | string | no | none |
| `item_quantity` | body | integer | no | none |
| `item_value` | body | integer | no | none |
### Responses
| HTTP Status Code | Meaning | Description | Data schema |
| -------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline |
| 422 | [Bad Request](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline |
### Data Schema
**Description:**
| Name | Type | Required | Restrictions | Title | description |
| ------------------------------------- | ------- | -------- | ------------ | ----- | ----------- |
| `data` | object | true | none | | none |
| `data.status` | string | true | none | | none |
| `data.uuid` | string | true | none | | none |
| `data.order_number` | string | true | none | | none |
| `data.fleet_identity_number` | string | true | none | | none |
| `data.status` | string | true | none | | none |
| `data.status_label` | string | true | none | | none |
| `data.sender_longitude` | null | true | none | | none |
| `data.sender_latitude` | null | true | none | | none |
| `data.customer_longitude` | null | true | none | | none |
| `data.customer_latitude` | null | true | none | | none |
| `data.delivery_fee` | integer | true | none | | none |
| `data.total_delivery_amount` | integer | true | none | | none |
| `data.service_charge` | integer | true | none | | none |
| `data.rider_commission` | null | true | none | | none |
| `data.currency` | string | true | none | | none |
| `data.note` | null | true | none | | none |
| `data.creation_mode` | null | true | none | | none |
| `data.created_at` | string | true | none | | none |
| `data.pickup_at` | null | true | none | | none |
| `data.dropoff_at` | null | true | none | | none |
| `data.customer_detail` | array | true | none | | none |
| `data.sender_detail` | object | true | none | | none |
| `data.sender_detail.uuid` | string | true | none | | none |
| `data.sender_detail.sender_name` | string | true | none | | none |
| `data.sender_detail.sender_phone` | string | true | none | | none |
| `data.sender_detail.sender_email` | string | true | none | | none |
| `data.sender_detail.sender_phonecode` | string | true | none | | none |
| `data.sender_detail.sender_address` | string | true | none | | none |
| `data.sender_detail.business_owned` | boolean | true | none | | none |
| `data.sender_detail.created_at` | string | true | none | | none |
| `data.sender_detail.updated_at` | string | true | none | | none |
| `data.rider_info` | null | true | none | | none |
| `data.delivery_info_from_rider` | null | true | none | | none |
| `data.is_paid` | boolean | true | none | | none |
| `data.pickup_photo` | null | true | none | | none |
| `data.dropoff_photo` | null | true | none | | none |
| `data.cancellation_reason` | null | true | none | | none |
| `data.cancelled_by` | object | true | none | | none |
| `data.cancelled_by.name` | null | true | none | | none |
| `data.cancelled_by.photo` | null | true | none | | none |
| `message` | string | true | none | | none |
```json sample response theme={null}
{
"status": "success",
"data": {
"uuid": "9fd136b9-dd33-4006-859b-5e57906f02b4",
"order_number": "41127",
"fleet_identity_number": "63471915",
"status": "Pending",
"status_label": "Pending",
"sender_longitude": null,
"sender_latitude": null,
"customer_longitude": null,
"customer_latitude": null,
"delivery_fee": 5000,
"total_delivery_amount": 5250,
"service_charge": 125,
"rider_commission": null,
"currency": "NGN",
"note": null,
"creation_mode": null,
"created_at": "2025-04-15T18:25:54.000000Z",
"pickup_at": null,
"dropoff_at": null,
"customer_detail": [],
"sender_detail": {
"uuid": "8e09f8fe-147a-4178-b3be-6b7eec4bf849",
"sender_name": "Emmanuel Chinatuka",
"sender_phone": "08087168391",
"sender_email": "chimaobinice@gmail.com",
"sender_phonecode": "234",
"sender_address": "2 Umuleri street, Lagos",
"business_owned": false,
"created_at": "2025-04-15T18:25:54.000000Z",
"updated_at": "2025-04-15T18:25:54.000000Z"
},
"rider_info": null,
"delivery_info_from_rider": null,
"is_paid": true,
"pickup_photo": null,
"dropoff_photo": null,
"cancellation_reason": null,
"cancelled_by": {
"name": null,
"photo": null
}
},
"message": "Delivery created successfully"
}
```