Update Account User
Updates information for a specific user in your account.
Endpoint
POST
v5/accountuser/{user_id}
Requires authentication.
Path Parameters
The user to update.
user_id
string
required
The ID of the account user to update.
Query Parameters
email
string
A new email address for the user.
username
string
A new display name for the user.
team
integer
The ID of a team to add the user to.
defaultteam
integer
The ID of the team to set as the user's default team.
admin
integer
Whether to grant account administrator privileges. Accepted values:
1 (admin), 0 (standard user).phone_support
integer
Whether to enable phone support access. Accepted values:
1 (enabled), 0 (disabled).userstatus
string
The account status to set for the user. Accepted values:
Active, Disabled.license
string
The license type to assign to the user. Accepted values:
Full Access, Reporting, Market Researcher, Educational, HR Professional, Basic, Standard.userdata
object
Custom user data fields to update. Each key is the column name of the custom field.
child attributes
column_name
string
The value to set for the named custom field. Example:
userdata[department]=sales.Response
Returns the updated account user object.
result_ok
boolean
Whether the request succeeded.
data
object
The updated account user object.
child attributes
id
string
The unique ID of the user.
username
string
The user's display name after the update.
email
string
The user's email address after the update.
admin
integer
Whether the user has account administrator privileges.
1 = admin, 0 = standard user.phone_support
integer
Whether phone support access is enabled for the user.
1 = enabled, 0 = disabled.userdata
array | object
Custom user data fields set on the user. Returns an empty array
[] if none are set.license
string
The license type assigned to the user after the update.
defaultteam
string | boolean
The ID of the user's default team, or
false if no default team is set.status
string | null
The user's account status after the update. Possible values:
Active, Disabled, or null.last_login
string | null
Timestamp of the user's most recent login (EST/EDT), or
null if the user has not yet logged in.api_key
string | null
The user's API token, if one has been generated. Returns
null if no token exists.api_secret
string | null
The user's API token secret, if one has been generated. Returns
null if no token exists.Examples
Request (cURL)
curl -X POST "https://api.alchemer.com/v5/accountuser/{{user_id}}?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&userstatus=Active"
Response
{
"result_ok": true,
"data": {
"id": "123456",
"username": "Jane Smith",
"email": "jane.smith@example.com",
"admin": 1,
"phone_support": 0,
"userdata": [],
"license": "Full Access",
"defaultteam": "1000125",
"status": "Active",
"last_login": "2026-04-06 10:39:20",
"api_key": "YOUR_API_TOKEN",
"api_secret": "YOUR_API_TOKEN_SECRET"
}
}