Create user

post

https://cloud.tenable.com/users

Creates a new user.

Requires the Administrator [64] user role or the PS.ACCT_MGMT.AM_ACCESS_CONTROL.CREATE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

username

string

required

Specifies the login name for the user. A valid username must be in the format name@domain, where domain corresponds to a domain approved for your Tenable Vulnerability Management instance.

Note: During initial setup, Tenable configures approved domains for your Vulnerability Management instance. To add domains to your instance, contact Tenable Support.

password

required

Specifies the initial password for the user. Passwords must be at least 12 characters long and contain at least one uppercase letter, one lowercase letter, one number, and one special character symbol.

permissions

int32

Specifies the user role as an integer value, as described in User Roles. If omitted, the system applies the Basic [16] user role by default.

name

string

Specifies the name of the user (for example, first and last name).

string

Specifies the email address of the user. A valid email address must be in the format name@domain, where domain corresponds to a domain approved for your Tenable Vulnerability Management instance. Administrators can create users with an email address that has a domain outside of the approved domains.

This email address overrides the email address set in username. If omitted, the system uses the username value as the user's email address.

Note: During initial setup, Tenable configures approved domains for your Vulnerability Management instance. To add domains to your instance, contact Tenable Support.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specified invalid parameters or if your request was improperly formatted.

403

Returned if you do not have permission to create a user.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the user account was created successfully.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred.