Create evaluation account v2

Creates an evaluation account. An evaluation account grants the customer 30 days of trial access to the specified Tenable applications. Activation can take up to five minutes to complete.

Caution: Legacy license packaging is deprecated, and Tenable plans to end support for it after March 1, 2027. Tenable recommends that customers specify a base tier and its add-ons in licensed_apps instead. Please update any existing integrations that your organization has.

Requires the Administrator [64] user role. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

The name of the customer account.

licensed_apps
array of strings
required

Specifies the Tenable applications to license for the evaluation account. Tenable supports two packaging models, and the values you specify determine which one applies to the account.

New license packaging. Specify exactly one base tier, along with any add-ons available for that tier:

  • vm—Tenable Vulnerability Management. Available add-on: asm.
  • foundation—Tenable One Foundation. Available add-ons: ad, ai, and cnapp.
  • advanced—Tenable One Advanced. Available add-ons: ad, ai, and cnapp.
Add-on codes are ad for Tenable Identity Exposure, ai for AI Exposure, asm for Tenable Attack Surface Management, and cnapp for Full CNAPP. For example, ["advanced"], ["vm", "asm"], or ["foundation", "ai", "cnapp"]. Specifying more than one base tier, or an add-on that is not available for the base tier you specify, returns a 400 response.

Legacy packaging. Specify any combination of ad, asm, cnapp, cns, lumin, one, pci, vm, and was; for example, ["vm", "was", "asm"].

Caution: Legacy packaging is deprecated, and Tenable plans to end support for it after March 1, 2027. Tenable recommends that you migrate existing integrations to the new license packaging by specifying a base tier and its add-ons in place of a combination of legacy application codes. Please update any existing integrations that your organization has.

licensed_apps*
string
required

The default email address used for contacting the owner of the evaluation account. The domain name of the email address must match the MSSP partner's domain name.

string
required

Specifies the email address of the MSSP partner.

string
required

A unique username for the evaluation account. It must be in email format, ex. [email protected], and the domain name of the email address must match the MSSP partner's domain name.

string
required

Specifies the Tenable AWS cloud region that hosts the evaluation account. Supported values: AU, BR, CA, EU, IN, JP, SG, UK, US.

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.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html