Assign a Driver

What does it do?

The assign driver endpoint allows you to provide driver and vehicle details for an accepted booking. Once assigned, the booking transitions to DRIVER_ASSIGNED status and you can begin sending driver events.

How it works

1. Accept booking      →  POST /v1/bookings/:customerReference/:bookingReference/responses
2. Assign driver       →  POST /v2/bookings/:bookingReference/assignDriver
3. Send driver events  →  POST /v1/bookings/:customerReference/:bookingReference/driver/events

Note

You do not need to create a driver first. Simply provide the driver's name, phone number, and optionally vehicle details directly in the assign request.

Key points

• You can call the assign endpoint multiple times to update driver/vehicle details
• Booking must be in ACCEPTED or DRIVER_ASSIGNED state
• Driver and vehicle can be assigned separately or together in a single call

See the endpoint reference for full request/response details.

Further reading

• How can I Assign a Driver via API? — V2 assignment details
• Why when I assign a driver the phone number is flagged as invalid? — Phone number validation troubleshooting