User Object

The user object is included in the Create and Update User endpoints and is included in some webhook callbacks when referring to driver and dispatch events.

Request Data

Below is a list of parameters you can send as part of the user object, for example, when sending the Create User request.

Read our Data Formatting article for more details about how different parameter types, such as datetime, are formatted and used in Bringg.

Parameter	Description
`admin` _boolean	Indicates if the user has administrative privileges.
`dispatcher` _boolean	Indicates if the user is a dispatcher.
`company_id` _string	Bringg's ID for the group of users within a team. See Get Companies.
`company_external_id` _string	Your external system's ID for the group of users within a team. See Get Companies.
`crew_external_id` _string	Your external system's ID for the driver's delivery crew, used to coordinate meetups and floating helper tasks during planned routes.
`driver` _boolean	Indicates if the user is a driver.
`email` _string	The user's email.
`emergency_contact_name` _string	Name of emergency contact (for use with the Rapid SOS application).
`emergency_contact_phone` _string	Phone number of emergency contact (for use with the Rapid SOS application).
`external_id` _string	The unique identifier for the user in your external system.
`external_team_ids` _{array of strings}	An array of your external system's IDs for the teams to which the user belongs.
`home_address` _string	The address of the user's "home" base, usually a warehouse or store location.
`home_lat` _number	The latitude of the user's "home" base.
`home_lng` _number	The longitude of the user's "home" base.
`language` _string	The user's preferred language.
`name` _string	The user's name.
`password` _string	The user's password, which should be changed after initial login.
`phone` _string	The user's phone number.
`privilege_id` _integer	The ID of the dispatcher or driver's Privileges group, which associates a dispatcher user with a set of authorization flags.
`private_vehicle` _boolean	Indicates whether the driver uses their own vehicle to determine if mileage should be compensated.
`skills` _{array of strings}	Driver capabilities, such as `installation`. Bringg matches these skills with the `required_skills` parameter to automatically assign routes to the most suitable driver based on their capabilities.
`team_ids` _{array of strings}	The IDs of the teams to which the user belongs.
`user_type_external_id` _string	The driver user role ID in your external systems. Can be used instead of `user_type_id`.
`user_type_id` _integer	The ID of the user type within Bringg.

Response & Webhook Data

Below is a list of the data returned in webhooks and responses to your API requests. The inclusion of specific parameters may depend on your use case, your API request, and the webhook fields you have subscribed to.

Parameter	Description
`access_token` _string	The access token for the user.
`active_shift_id` _integer	The ID of the driver's current shift.
`authentication_token` _string	The authentication token for the user.
`active_team_id` _integer	The ID of the team the driver is currently assigned to.
`at_home` _boolean	Indicates whether the driver is located at their "home" base, usually a store or warehouse.
`average_rating` _number	The average rating the driver has received.
`app_id` _string	The ID of the mobile app the user is using.
`battery` _integer	The current battery level of the user's device.
`confirmation_code_sent_at` _datetime	The timestamp when the confirmation code allowing the new user to login was sent.
`created_at` _datetime	The timestamp when the user was created.
`current_task_id` _integer	The ID of the order the driver is actively fulfilling.
`current_vehicle_id` _integer	The ID of the vehicle currently assigned to the user.
`current_unavailability_id` _integer	The ID of the user's current unavailability status.
`device_model` _string	The model of the user's mobile device.
`driver_current_sign_in_at` _datetime	The timestamp of the driver's current sign-in.
`driver_last_sign_in_at` _datetime	The timestamp of the driver's last sign-in.
`driver_sign_in_count` _integer	The number of times the driver has signed in.
`eta_to_home` _datetime	The estimated time of arrival to the driver's "home" base.
`mobile_type` _string	The type of mobile device the user is using.
`mobile_version` _string	The version of the mobile app the user is using.
`team_external_ids` _{array of strings}	An array of your external system's IDs for the teams to which the user belongs.
`private_vehicle` _boolean	Indicates whether the driver uses their own vehicle to determine if mileage should be compensated.
`skills` _{array of strings}	Driver capabilities, such as `installation`. Bringg matches these skills with the `required_skills` parameter to automatically assign routes to the most suitable driver based on their capabilities.
`beta` _boolean	Indicates if the user is part of a beta program.
`email` _string	The user's email.
`email_hash` _string	The hash of the user's email.
`id` _integer	The unique identifier of the user.
`job_description` _string	The user's job description.
`last_logs_requested_at` _datetime	The timestamp when the user's logs were last requested.
`lat` _number	The latitude of the user's last reported location.
`lng` _number	The longitude of the user's last reported location.
`merchant_id` _integer	The ID of the merchant to which the user belongs.
`mobile_configuration` _object	The saved settings for the driver's mobile app.
`name` _string	The user's name.
`num_ratings` _integer	The number of ratings the driver has received.
`os_version` _string	The operating system version of the driver's mobile device.
`phone_hash` _string	The hash of the user's phone number.
`password_hash` _string	The hash of the user's password.
`profile_image` _string	The URL of the user's profile image.
`push_token` _string	The push token for the user's device.