# User Management

Create, update, and manage system users within your organization. Users can be admins, supervisors, or agents. Manage agent availability for live chat assignment, set concurrent chat limits, and handle password changes. Each user belongs to a client and can be assigned to teams.


## Get my profile

 - [GET /payless4messaging-service/WhatsApp/api/v1/users/me](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getme.md): Returns the authenticated caller's own profile as a credential-free UserResponse.

## List your organization's user

 - [GET /payless4messaging-service/WhatsApp/api/v1/users](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/listclientusers.md): Returns every user in the authenticated client's organization as a lean summary — id, name, email, role, live-chat role, avatar, and availability — with no credentials or secrets. Use this to populate transfer/assignment pickers and agent lists. The client is taken from your authentication context.

## Create a user

 - [POST /payless4messaging-service/WhatsApp/api/v1/users](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/createuser.md): Create an organization user. Takes no password — a one-time temporary password is generated and returned once in the response; the user must set their own password on first login. The client is taken from clientRef, or your auth context when omitted.

## Update a user

 - [PUT /payless4messaging-service/WhatsApp/api/v1/users](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/updateuser.md): Update an organization user's profile, identified by id. Carries no credentials and returns a credential-free UserResponse.

## Delete a user

 - [DELETE /payless4messaging-service/WhatsApp/api/v1/users/{id}](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/deleteuser.md): Soft-deletes an organization user, identified by id: the user is disabled, signed out, and removed from any teams, but the record is retained. Carries no credentials.

## List users (paginated)

 - [GET /payless4messaging-service/WhatsApp/api/v1/users/page](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getuserspage.md): Retrieve a paginated list of a client's users as credential-free UserResponse records.

## Change availability

 - [PUT /payless4messaging-service/WhatsApp/api/v1/users/availability](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/changeavailability.md): Toggle the authenticated agent's online/offline status; returns a credential-free UserResponse.

## Set agent chat limit

 - [PUT /payless4messaging-service/WhatsApp/api/v1/users/agent-chat-limit](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/setagentchatlimit.md): Set the maximum number of concurrent chats an agent can handle for the given client.

## Change my password

 - [POST /payless4messaging-service/WhatsApp/api/v1/users/me/password/change](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/changemypassword.md): Change the authenticated caller's own password. Requires old password, new password, and confirmation.

## Get my WhatsApp credits

 - [GET /payless4messaging-service/WhatsApp/api/v1/users/me/credits](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getmycredits.md): Retrieve the WhatsApp credit balance for the authenticated caller.

## Create a system user (deprecated)

 - [POST /payless4messaging-service/WhatsApp/SystemUsers](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/createsystemuser.md): Deprecated. Accepts and returns credential-bearing SystemUser fields. Use Create a user (POST /api/v1/users), which takes no password and returns a one-time temporary password instead.

## Update a system user (deprecated)

 - [PUT /payless4messaging-service/WhatsApp/SystemUsers](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/updatesystemuser.md): Deprecated. Accepts and returns credential-bearing SystemUser fields. Use Update a user (PUT /api/v1/users), which is identified by id, carries no credentials, and returns a UserResponse.

## Get current logged-in user (deprecated)

 - [GET /payless4messaging-service/WhatsApp/SystemUsers/getCurrentLoginSystemUser](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getcurrentuser.md): Deprecated. Returns credential-bearing SystemUser fields. Use Get my profile (GET /api/v1/users/me), which returns a credential-free UserResponse.

## Get all users in your organization (supervisor-only) (deprecated)

 - [GET /payless4messaging-service/WhatsApp/SystemUsers/getCurrentClientUsers](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getclientusers.md): Supervisor-only. Returns the full SystemUser records for the client (including credential-bearing fields), so it is restricted to callers with the supervisor role and returns 403 otherwise. For agent-facing user lists use List your organization's users, which returns a lean, credential-free UserSummary[].

## Get users for a specific client (paginated) (deprecated)

 - [GET /payless4messaging-service/WhatsApp/SystemUsers/getUsersForClient](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getusersforclient.md): Deprecated. Returns credential-bearing SystemUser records. Use List users (paginated) (GET /api/v1/users/page), which returns credential-free UserResponse records.

## Change agent availability status (deprecated)

 - [PUT /payless4messaging-service/WhatsApp/SystemUsers/changeAvailableStatus](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/changeavailabilitystatus.md): Deprecated. Returns credential-bearing SystemUser fields. Use Change availability (PUT /api/v1/users/availability), which returns a credential-free UserResponse.

## Update agent chat limit (deprecated)

 - [PUT /payless4messaging-service/WhatsApp/SystemUsers/updateAgentChatLimit](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/updateagentchatlimit.md): Deprecated. Use Set agent chat limit (PUT /api/v1/users/agent-chat-limit). Behaviour is identical.

## Change password (deprecated)

 - [POST /payless4messaging-service/WhatsApp/SystemUsers/changePassword](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/changepassword.md): Deprecated. Use Change my password (POST /api/v1/users/me/password/change). Behaviour is identical.

## Get WhatsApp credits for current user (deprecated)

 - [GET /payless4messaging-service/WhatsApp/SystemUsers/getWhatsAppCreditsForCurrentLoginUser](https://ecommunicate-api-docs.redocly.app/apis/omnichannel/user-management/getwhatsappcreditsforcurrentloginuser.md): Deprecated. Use Get my WhatsApp credits (GET /api/v1/users/me/credits). Behaviour is identical.