DocumentationAPI ReferenceRelease Notes
API Reference

Create credential secret

Creates a credential secret in the folder with the given folder ID.

Required Permission(s)

Any of the following:

  • Secrets Safe (Read)
  • Workforce Passwords (Read)

Notes

  • When OwnerType is set to "User", then a list of Owners is required. When OwnerType is set to "Group", the OwnerId is required (as the GroupId)
  • Either a Password or a PasswordRuleID is required:
    • If a PasswordRuleID is passed in, then a password is generated based on the Password Policy
    • If a Password is passed in instead, that password is used directly

API Versions

  • Version 3.2 - Includes SecretValueModifiedOn in applicable response models
  • Version 3.1 - Using Owners collection
  • Version 3.0 - Using obsolete owner properties
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

ID of the target folder

Query Params
string
Defaults to 3.0

API version for response format

Body Params

Model data with which to perform the operation

string
required
length between 0 and 256

Credential username

string | null

Credential password

int32 | null
0 to 32767

Password will be auto-generated using the specified password policy

string
required
length between 0 and 256

Title of the secret

string | null

Additional information relevant to the secret

Owners
array of objects | null

List of owners of the secret

Owners
string | null

Notes relevant to the secret

Urls
array of objects | null

List of URLs relevant to the secret

Urls
Headers
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

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

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.