patch
https://hover.to/api/v1/orgs//users/
Updates a user in the authenticated Hover organization
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
This endpoint updates an existing user in your organization. Use it to change a user’s details, or to set or change their preferred_identifier, which is their ID from your own system, such as an employee ID. On success, the API returns 200 OK with the updated user.
A few things to know:
- The user must belong to the organization in the URL, or the request returns 404. Organization tokens can also update users in child organizations.
- Each
preferred_identifiermust be unique within the organization. A duplicate returns422, and none of the changes in that request are saved. - To clear a user’s preferred_identifier, send an empty value
Sample Request Body
//PATCH https://hover.to/api/v1/orgs/{org_id}/users/USER_ID
{
"user": {
"email": "[email protected]",
"first_name": "Jane",
"last_name": "Smith",
"mobile_phone": "+15555550123",
"office_phone": "+15555550100",
"time_zone": "Pacific Time (US & Canada)",
"preferred_identifier": "EMP-004821",
}
} 404Not Found. The user doesn't belong to the organization in the URL.

