Create a User

post

https://portal-cert.shieldconex.com:4010/api/v1/users

This endpoint creates a User for either a Partner or a Client. To create a user for a Client, both the Partner and Client references must be included.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

username

string

required

length ≤ 255

The unique Username used to login.

firstName

string

required

length ≤ 255

The user's first name.

lastName

string

required

length ≤ 255

The user's last name.

string

required

length ≤ 255

The user's email address.

phone

integer

required

The user's phone number. Must be a valid phone number.

partner

object

The partner under which the user should be created. Required for creating users that have the Partner-level roles.

client

object

The partner under which the user should be created. Required for creating users that have the Client-level roles.

userRole

object

required

The role the user will be created with. Cannot be a higher permission level than the role creating it.

isActive

boolean

required

The activation status of the user being created. Only active users are able to access ShieldConex.

sendWelcomeEmail

boolean

required

When this flag is set to true, the new user will recieve a welcome email upon successful creation of a user. It is recommended to set this to true only for active users.

Body Params

User to be created.

userName

string

required

length ≤ 255

The User's unique username.

firstName

string

required

length ≤ 255

The User's name.

lastName

string

required

length ≤ 255

The User's Surname.

string

required

length ≤ 255

The User's email address.

phone

string

required

length ≤ 255

The User's phone number without dashes, spaces, or brackets (e.g. +14155552671).

partner

object

Reference to the associated Partner. When used for POST and PATCH API calls, the reference can contain either the ID or Name. With GET API calls, both properties are populated.

client

object

Reference to the associated Client resource. When used for POST and PATCH API calls, the reference can contain either the ID or Name. With GET API calls, both properties are populated.

userRole

object

required

Reference to the associated User Role.

isActive

boolean

This property indicates if the User account is active or disabled. Once a user has logged into the system, their account cannot be deleted. As an alternative, their account can be set to inactive.

sendWelcomeEmail

boolean

If this property is set to 'true' the newly created user will be sent a welcome email.

Responses

401

Unauthorized

403

Forbidden

200User create response

409Invalid data

500Internal server error