User Passwords

Set a User's Password

POST /api/v2/users/{user_id}/password.json

Allowed For
  • Admins

An admin can set a user's password only if the setting is enabled under Settings > Security > Global. The setting is off by default. Only the account owner can access and change this setting in Zendesk Support.

Using curl
curl https://{subdomain}.zendesk.com/api/v2/users/{user_id}/password.json \
  -X POST -d '{"password": "newpassword"}' -H "Content-Type: application/json" \
  -v -u {email_address}:{password}
Example Response
Status: 200

Change Your Password

PUT /api/v2/users/{user_id}/password.json

Allowed For
  • Agents
  • End Users

You can only change your own password. Nobody can change the password of another user because it requires knowing the user's existing password. However, an admin can set a new password for another user without knowing the existing password. See "Set a User's Password" above.

Using curl
curl https://{subdomain}.zendesk.com/api/v2/users/{user_id}/password.json \
  -X PUT -d '{"previous_password": "oldpassword", "password": "newpassword"}' \
  -v -u {email_address}:{password} -H "Content-Type: application/json"
Example Response
Status: 200

Get a list of password requirements

GET /api/v2/users/{user_id}/password/requirements.json

Allowed For
  • Agents
  • End Users
Using curl
curl https://{subdomain}.zendesk.com/api/v2/users/{user_id}/password/requirements.json \
  -v -u {email_address}:{password} -H "Content-Type: application/json"
Example Response
Status: 200

{
  "requirements": [
    "must be at least 5 characters",
    "must be different from email address"
  ]
}