Create a User

Add users to your organization

EndPoint

POST /v1/users/create
X-API-Key: your-api-key-goes-here
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

Form Data Fields

Field Name	Type	Required	Description
file	File	❌	The file to upload (e.g., .jpg, .png)
first_name	String	✅	User's first name
last_name	String	✅	User's last name
email	String	✅	User's email
phone	String	❌	User's phone number
role	String	❌	Roles could dispatcher, or superadmin (default: superadmin)

Response

{
    "success": true,
    "data": {
        "first_name": "test",
        "last_name": "name",
        "name": "test name",
        "email": "[email protected]",
        "phone": "+16348398434",
        "role": "dispatcher",
        "driver_app_settings": {
            "allow_start_task_out_of_order": false,
            "warn_starting_task_out_of_order": false,
            "warn_starting_task_before_complete_after_time": false,
            "allow_handed_to_customer": false,
            "allow_photos_upload": true,
            "allow_initiate_communication": true,
            "allow_manual_barcodes": false,
            "notes_pickup": 1,
            "notes_dropoff": 1,
            "signature_pickup": 0,
            "signature_dropoff": 0,
            "photo_pickup": 1,
            "photo_dropoff": 1
        },
        "owner": {
            "_id": "673f391fb210f0e18b15c4d3"
        },
        "teams": [],
        "user_image": "",
        "updated_at": "2025-06-28T09:53:47.614Z",
        "verified": false,
        "verificationToken": "bb815f60a7c310f4eccd00bb191dbc623208ca5095f7c6a9c7d35021a3b83fd2",
        "tokenExpiration": "2025-06-28T10:53:57.009Z",
        "_id": "685fbbb51d92e557a6afac70",
        "__v": 0
    }
}