Fleet & Rider Dispatch

Manage carrier fleets, invite drivers, and claim orders via QR tags.

POST

Email a fleet-join invite link to a driver or dispatcher. If the address belongs to an existing rider account, they also get an in-app + push notification.

Authentication: JWT (Merchant / Carrier)

Request Body Fields

Field	Type	Requirement	Description
email	string	Required	Invitee email address — the accept link is delivered here.
phone	string	Optional	Invitee mobile phone number (+234...).
role	string	Optional	RIDER (default) or DISPATCHER.

Request ExampleHTTPS Live Endpoint

curl -X POST https://api.tumr.app/api/v1/invitations/ \
  -H "Authorization: Bearer YOUR_CARRIER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "phone": "+2348099887766"
  }'

Response Payload

201 Created

application/json

{
  "id": "a1b2c3d4-1234-4abc-9def-0123456789ab",
  "email": "[email protected]",
  "phone": "+2348099887766",
  "role": "RIDER"
}

Previous TopicAddresses & Geocoding

Next TopicWallet, Escrow & Settlements