User Passwords

Set a User's Password

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

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"
  ]
}