Add new driver to company

PUT

/driver

Endpoint to add a new driver to the company with ID equal to company_id.

User Role Permissions

The following table shows which user roles are allowed to send requests using this API endpoint.

Role	Permission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Body Params multipart/form-data

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Card ID exists

🟠401Login Required

🟠400Invalid `phone_number` parameter

🟠403Group not permitted

🟠404Group doesn't exist

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://fleet.roscolive.com/api/v1.0/driver' \
--form 'company_id="12345"' \
--form 'first_name="{% faker name.firstName %}"' \
--form 'last_name="{% faker name.lastName %}"' \
--form 'email="{% faker internet.exampleEmail %}"' \
--form 'card_id="A1B2C3D4"' \
--form 'group_id="12345"' \
--form 'guid=""' \
--form 'legal_consent=""' \
--form 'phone_number=""'

Response Example

200 - Success

{
    "meta": {
        "code": 200
    },
    "response": {
        "card_id": "a2b3c4d5",
        "card_scan_ts": null,
        "company_id": 2,
        "creation_ts": "2024-08-09 18:17:37",
        "device_id": null,
        "driver_gallery_complete": false,
        "email": "Jeanette.Christiansen@example.org",
        "first_name": "Makayla",
        "group_id": null,
        "group_name": null,
        "guid": "410e8300-d18a-52b1-a716-427766220000a",
        "id": 2842,
        "last_consent_ts": "2025-11-12 14:18:13",
        "last_name": "Goldner",
        "legal_consent": true,
        "name": "Makayla Goldner",
        "parent_driver_id": null,
        "phone_number": "1234567890",
        "photos": [],
        "status": "used",
        "type": "manual"
    },
    "result": "OK"
}

Modified at 2026-03-06 18:01:42

Get driver scores

Get company event score weights

Add new driver to company

User Role Permissions#

Request

Responses

User Role Permissions