Add User

curl --request POST \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/user \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userName": "<string>",
  "fullName": "<string>",
  "emailAddress": "<string>",
  "roleId": "<string>",
  "externalIdentifier": "<string>"
}
'

{
  "token": "<string>",
  "expiryTime": "2023-11-07T05:31:56Z",
  "user": {
    "userName": "<string>",
    "fullName": "<string>",
    "emailAddress": "<string>",
    "roleId": "<string>",
    "externalIdentifier": "<string>"
  }
}

/user

Add User

POST request to add a web user.
You cannot include the password for the new user in the same request as adding a user, instead you must use the Set User Password endpoint and include the token from the output response of this endpoint.
The generated token will expire if it is not used within 30 days or if a password reset token is requested.
If a value for externalIdentifier is specified, then the user will be enabled for SSO and a Connect password cannot be set.
If the user being created will be using the SmarterDriver Mobile application and login using SSO, then the same values must be specified for both username and emailAddress.
The details for the user are in a JSON object included in the HTTP body.
Ensure you have set the content-type of the request body to “application/json;charset=UTF-8”.

POST

customer

{customerId}

user

Add User

curl --request POST \
  --url https://api.masternautconnect.com/connect-webservices/services/public/v1/customer/{customerId}/user \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userName": "<string>",
  "fullName": "<string>",
  "emailAddress": "<string>",
  "roleId": "<string>",
  "externalIdentifier": "<string>"
}
'

{
  "token": "<string>",
  "expiryTime": "2023-11-07T05:31:56Z",
  "user": {
    "userName": "<string>",
    "fullName": "<string>",
    "emailAddress": "<string>",
    "roleId": "<string>",
    "externalIdentifier": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId

string

required

Body

application/json

userName

string

Username for the web user

fullName

string

Full name of the user

emailAddress

string

Email address of the user

roleId

string

Role identifier for the user

externalIdentifier

string

External identifier for SSO integration

Response

User was successfully created

token

string

Security token for password reset

expiryTime

string<date-time>

Token expiry time

user

object

Created user details

Show child attributes

List User List User Details

⌘I

API Documentation

Authorizations

Path Parameters

Body

Response