Overview
Create a delivery using atempDeliveryId obtained from the pricing endpoint. This converts the price estimate into an actual delivery that can be paid for and dispatched.
Required permission:
delivery:createEndpoint
Request
Headers
string
required
Your Chidori API key
string
required
Must be
application/jsonBody parameters
string
required
The temporary delivery ID from the pricing response
string
A descriptive name for the delivery (e.g., “Office Supplies”)
string
Type of delivery. Options:
SendDelivery or RequestPickupstring
Phone number of the recipient (e.g.,
+2348012345678)string
Phone number of the sender (e.g.,
+2348087654321)string
Any special instructions for the driver
string
ISO 8601 datetime for scheduled deliveries (e.g.,
2025-01-15T10:00:00.000Z)Response
Success response
boolean
Always
true for successful requestsobject
Examples
Delivery workflow
1
Get price estimate
Call
/api/pricing/single to get a tempDeliveryId2
Create delivery
Use this endpoint with the
tempDeliveryId3
Pay for delivery
Call
/api/payments/charge with the delivery ID4
Track delivery
Use webhooks or WebSocket for real-time updates
Delivery statuses
Next steps
Pay for Delivery
Complete the delivery by processing payment
Track Delivery
Get delivery details and status
