Users

/v1/users

Use the users node for managing authentication and accessing the WhatsApp Business On-Premises API Client.

Before You Start

The WhatsApp Business On-Premises API Client has a default account with admin set as the username with a password of secret. This account cannot be removed or deleted from the system. For security reasons, you are required to change the admin password immediately.

If you forget your password, please contact Direct Support for assistance with resetting it.

Limitations

• Only the admin account can create or delete users.

Recommendations

• Use the admin account only to create or delete users
• Create user accounts to manage your WhatsApp Business On-Premises API Clients

Creating

To create an account for a user within your business who can access the WhatsApp Business API, send the username and password to the WhatsApp Business On-Premises API Client using the /users endpoint. It validates the username and password and creates a new account if one does not already exist for that username. The password is processed with a one-way hash and stored in a data volume. Both username and password are required parameters.

Example

To create a user, send a request like:

POST /v1/users
Authorization: Bearer your-auth-token

{
  "username": "username",
  "password": "password"
}

If the request is successful and a user account is created, you receive an HTTP status code of 201 Created and the following payload:

{
  "users": [{
     "username": "username"
  }]
}

If the request is not successful, you receive an HTTP status code, along with a WhatsApp error code. If you submit a duplicate username, the error response looks like this:

{
  "errors": [{
    "code": 1014,
    "title": "Internal error",
    "details": "Unable to create user. Already exist?"
  }]
}

Parameters

Edges

The following edges are connected to this node:

Common Errors

If there are other errors in the response, refer to the following sources for more information: Error Codes and HTTP Status Codes.