Edit Member

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"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "teams": [1, 2, 5],
      "role": "worker"
    }
  }'

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",
      "name": "John Smith",
      "phone": "+14155559999",
      "email": "john.smith@company.com"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "working_hours": {
        "monday": {"start": 480, "end": 1020},
        "tuesday": {"start": 480, "end": 1020},
        "wednesday": {"start": 480, "end": 1020},
        "thursday": {"start": 480, "end": 1020},
        "friday": {"start": 480, "end": 1020},
        "saturday": {"start": 0, "end": 0},
        "sunday": {"start": 0, "end": 0}
      }
    }
  }'

{
  "status": 123,
  "account": {}
}

POST

api

editaccount

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"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "teams": [1, 2, 5],
      "role": "worker"
    }
  }'

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",
      "name": "John Smith",
      "phone": "+14155559999",
      "email": "john.smith@company.com"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "working_hours": {
        "monday": {"start": 480, "end": 1020},
        "tuesday": {"start": 480, "end": 1020},
        "wednesday": {"start": 480, "end": 1020},
        "thursday": {"start": 480, "end": 1020},
        "friday": {"start": 480, "end": 1020},
        "saturday": {"start": 0, "end": 0},
        "sunday": {"start": 0, "end": 0}
      }
    }
  }'

{
  "status": 123,
  "account": {}
}

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

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"

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 writable fields 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”)

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. Include all seven day keys (monday through sunday) when updating.
working_hours_overrides - Date-specific working-hours overrides
ignore_working_hours_until_ts - Temporary availability override

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
unit_date - Date format string (e.g., “dd.MM.yyyy”, “MM/dd/yyyy”)
timezone - Timezone string (e.g., “America/New_York”)
language - Language 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
  }
}

integer

required

Status code. 0 indicates success.

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"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "teams": [1, 2, 5],
      "role": "worker"
    }
  }'

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",
      "name": "John Smith",
      "phone": "+14155559999",
      "email": "john.smith@company.com"
    }
  }'

curl -X POST https://api.hellotracks.com/api/editaccount \
  --header 'API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  -d '{
    "data": {
      "uid": "abc123",
      "working_hours": {
        "monday": {"start": 480, "end": 1020},
        "tuesday": {"start": 480, "end": 1020},
        "wednesday": {"start": 480, "end": 1020},
        "thursday": {"start": 480, "end": 1020},
        "friday": {"start": 480, "end": 1020},
        "saturday": {"start": 0, "end": 0},
        "sunday": {"start": 0, "end": 0}
      }
    }
  }'

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.

Get Members - Retrieve member information
Create Member - Add new members
Delete Member - Remove members

API Documentation

Job Management

Dispatch and Routing

Location

Account Management

Place Management

Reports

No-Code Integrations

REQUEST

Identifying the Member

Editable Properties

Core Information

Role & Permissions

Status & Availability

Vehicle & Capacity

Working Hours

Route & Navigation

Preferences

Skills & Capabilities

Permissions

RESPONSE

Examples

​REQUEST

​Identifying the Member

​Editable Properties

​Core Information

​Role & Permissions

​Status & Availability

​Vehicle & Capacity

​Working Hours

​Route & Navigation

​Preferences

​Skills & Capabilities

​Permissions

​RESPONSE

​Examples

​Related Endpoints

REQUEST

Identifying the Member

Editable Properties

Core Information

Role & Permissions

Status & Availability

Vehicle & Capacity

Working Hours

Route & Navigation

Preferences

Skills & Capabilities

Permissions

RESPONSE

Examples

Related Endpoints