Update Employee Record

Programmatically update employee records, including contact information and shipping addresses.

Any record updated via this API is automatically reflected in the Locations app, Manage app → Users view, and the Shipping Address selector in Unduit's order workflows. This enables seamless integration between your internal HR/location systems and Unduit's IT Asset Management platform.

PUT

/api/v1/employee/update/{employee_id}

Description

Use the PUT Employee Record endpoint to programmatically update employee records with contact information and shipping addresses. Employee records updated through this API are immediately synchronized across Unduit apps (e.g. Shop, Buyback, Device Hub, Repair).

Request

Path Parameters

Parameter	Type	Required	Description
employee_id	String	Yes	Encrypted employee ID (e.g., VEl0K0tWdnVwWXJ4ai82RXFXTGNWZz98)

Headers

Header	Value	Required
Authorization	Bearer <access_token>	Yes
Content-Type	application/json	Yes

Request Body (JSON)

Field	Type	Required	Description	Validation Rules
firstname	String	Yes	First name of the user	Must not be empty, letters and spaces only
lastname	String	Yes	Last name of the user	Must not be empty, letters and spaces only
location_name	String	Yes	Name of the associated location	Must not be empty
location_type	String	Yes	Type of location	Must be: Warehouse, Corporate Office, Retail Store, or Remote Employee
contact_info	Number	Yes	Phone number for contact	Must contain only numbers
email	String	Yes	Email address of the contact	Must be valid email format and not empty
address_1	String	Yes	Address line 1	Must not be empty
address_2	String	No	Address line 2 (suite, apt, etc.)	Optional
city	String	Yes	City name	Must not be empty
state	String	Yes	State or province	Must not be empty
zip	String	Yes	Zip or postal code	Must not be empty
country	String	Yes	Country code (ISO 3166-1 alpha-2)	Valid ISO 3166-1 alpha-2 code (e.g., US, GB)
contact_country	String	Yes	Country code of contact's location	Must not be empty

Response

Response Fields

Field	Type	Description
message	string	Status message confirming successful update

Error Responses

Common error responses you may encounter when using this endpoint.

Notes

This endpoint requires valid authentication. Include your access token in the Authorization header.
The employee_id must be the encrypted employee ID obtained from the Employee Directory endpoint.
All required fields must be provided in the request body. Missing or invalid fields will result in an error.
The location_type field must be one of the following: Warehouse, Corporate Office, Retail Store, or Remote Employee.
Country codes must follow the ISO 3166-1 alpha-2 standard (e.g., US for United States, GB for United Kingdom).
Employee records updated via this API are immediately synchronized across all Unduit apps.

Related Endpoints

Employee Directory

Retrieve a paginated list of all employees

Create Employee Record

Add a new employee to your organization

Did this page help you?

Request

curl -X PUT https://dev-api.unduit.com/api/v1/employee/update/VEl0K0tWdnVwWXJ4ai82RXFXTGNWZz98 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "firstname": "John",
    "lastname": "Doe",
    "location_name": "San Francisco Remote Hub",
    "contact_info": "3242342",
    "email": "john.doe@example.com",
    "address_1": "123 Market Street",
    "address_2": "Suite 400",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94103",
    "country": "US",
    "contact_country": "US",
    "location_type": "Warehouse"
  }'

Success Response (200)

{
  "message": "Record updated successfully"
}

Error Responses

400 Bad Request

{
  "message": "Missing required fields: firstname, lastname"
}

401 Unauthorized

{
  "message": "Missing or invalid authentication token"
}

404 Not Found

{
  "message": "Employee record not found"
}

422 Unprocessable Entity

{
  "message": "Invalid email format",
  "errors": {
    "email": "Must be a valid email address"
  }
}