Update Account User
Updates information for a specific user in your account. All parameters are optional — only fields included in the request will be changed.
Endpoint
POST
v5/accountuser/{user_id}
Requires authentication. Accessible to Account Administrator users only.
Path Parameters
The user to update.
user_id
string
required
The ID of the account user to update.
Query Parameters
All parameters are optional. Include only the fields you want to change.
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. See Get Account User for the full list of response fields.
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.
status
string
The user's account status after the update. Possible values:
Active, Disabled.Examples
Request (cURL)
curl -X POST "https://api.alchemer.com/v5/accountuser/YOUR_USER_ID?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET&userstatus=Disabled"
Response
{
"result_ok": true,
"data": {
"id": "YOUR_USER_ID",
"username": "test",
"email": "user@example.com",
"admin": 0,
"phone_support": 0,
"userdata": [],
"license": "",
"defaultteam": false,
"status": "Disabled",
"last_login": null,
"api_key": null,
"api_secret": null
}
}