Skip to main content
curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "account": "worker@company.com",
      "status_label": "On Lunch Break"
    }
  }'
Update one or more properties of an existing member. You can modify profile information, status, role, team assignments, working hours, preferences, and more.

​
REQUEST

POST https://api.hellotracks.com/api/editaccount

{
   "data": {
      "account": "worker@company.com",
      "status_label": "Available",
      "phone": "+14155551234",
      "email": "newemail@company.com",
      "name": "Updated Name",
      "role": "dispatcher",
      "teams": [1, 2, 3],
      "vehicle_capacity": 500,
      "color": "#FF5733"
   }
}

​
Identifying the Member

​
account
string
One of account or uid is required to identify which member to edit.The username (email) of the member to edit.Example: "worker@company.com"
​
uid
string
One of account or uid is required to identify which member to edit.The unique identifier of the member to edit. Alternative to account.Example: "abc123"

​
Editable Properties

You can update any writable field from the Member API Object. Common editable properties include:

​
Core Information

  • name - Full name
  • phone - Phone number
  • email - Email address
  • color - Display color (hex format)

​
Role & Permissions

  • role - User role: “worker”, “operator”/“dispatcher”, or “administrator”
  • teams - Array of team numbers (integers)

​
Status & Availability

  • status_label - Custom status text (e.g., “Available”, “On break”)
  • status_label_ts - Timestamp when status was set (auto-updated)
  • moving - Movement status: “halted”, “idling”, “ontheway”, “offduty”

​
Vehicle & Capacity

  • vehicle_capacity - Vehicle capacity (weight/volume)
  • travel_mode - “car”, “bicycle”, “pedestrian”, “truck”, “van”, “motorcycle”

​
Working Hours

  • working_hours - Object with day-specific schedules (monday-sunday)
  • ignore_working_hours_until_ts - Temporary availability override

​
Route & Navigation

  • route_start_lat, route_start_lng - Daily route start location
  • route_end_lat, route_end_lng - Daily route end location
  • route_start_time - Daily start time in minutes from midnight

​
Preferences

  • unit_distance - “SI” (metric) or “US” (imperial)
  • unit_time - “12” or “24” hour format
  • date_format - Date format string (e.g., “dd.MM.yyyy”, “MM/dd/yyyy”)
  • timezone - Timezone string (e.g., “America/New_York”)
  • locale - Locale code (e.g., “en”, “de”, “fr”)

​
Skills & Capabilities

  • skills - Array of skill tags for job matching
  • expertise - Expertise level or specialty
See the Member API Object for the complete list of 55+ properties and their descriptions.

​
Permissions

  • Administrators: Can edit all members
  • Dispatchers: Can edit workers (limited permissions)
  • Workers: Can only edit their own profile (limited fields)
  • You must have appropriate permissions for the target member

​
RESPONSE

{
  "status": 0,
  "account": {
    "uid": "abc123",
    "username": "worker@company.com",
    "name": "Updated Name",
    "status_label": "Available",
    // ... complete updated member object
  }
}
​
status
integer
required
Status code. 0 indicates success.
​
account
object
Updated member object with all current properties. May be null if member was not found or no changes were made.See the Member API Object for complete structure.

​
Examples

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "account": "worker@company.com",
      "status_label": "On Lunch Break"
    }
  }'
Partial Updates: Only include the fields you want to change. Omitted fields will remain unchanged.
Complete Field Reference: See the Member API Object for documentation of all editable properties, their types, valid values, and descriptions.
⌘I