Skip to main content

Add user

POST https://www.digicert.com/services/v2/user

Use this endpoint to create a new user. To get available access roles, use the List container roles endpoint.

Notice

By default, the user will be created in the same container as the user associated with the API key used with the request.

Example requests and responses

Request parameters

Name

Req/Opt

Type

Description

username

required

string

Username for the profile.

Valid characters:a–z, A–Z, 0–9, @, -, _, +, .

first_name

required

string

First name of the user.

Character limit: 128

last_name

required

string

Last name of the user.

Character limit: 128

email

required

string

Email address of the user. Accepts only valid email addresses.

Character limit: 255

job_title

optional

string

Job title of the user. Required for user to be an EV approver.

Character limit: 64

telephone

optional

string

Telephone number of the user. Required for user to be an EV approver.

Character limit: 64

container

optional

object

Details of the user container.

Note: The container request parameter exists for a legacy use case. To restrict a user's access to one or more divisions, use the container_id_assignments array, instead.

.. id

optional

int

ID of the container the user will be created under.

access_roles

required

array

Container for access role ID.

.. id

required

int

ID of the access role to assign the user.

See Glossary – Access roles.

container_id_assignments

required

array

List of container IDs (divisions) the user will be assigned to. If set, this will override any default containers the user can view.

is_saml_sso_only

optional

bool

If true, the user can only log in to CertCentral via SAML SSO.

Default:false

Response parameters

Name

Type

Description

id

int

ID of the created user.