- API >
- Public API Resources >
- Groups and Users >
- Users >
- Create the First User
Create the First User¶
On this page
Create the first Ops Manager user. This endpoint is the only API call you can make without first having an API key.
Exceptions
- This endpoint cannot be used if Ops Manager uses LDAP for authentication.
- This endpoint can create the first user only if Ops Manager runs in
Invitation Only Mode
.
The user created through this endpoint is automatically granted the GLOBAL_OWNER role. The returned document includes the new user’s Public API key, which you can use to make further API calls.
The endpoint does not create a group, but you can use the new user and API key to create a group through the Projects resource in the API. You cannot login to Ops Manager until after you have created a group.
You can use this endpoint to create additional users. Users created after the first are not granted the GLOBAL_OWNER role automatically.
Base URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource¶
Request Path Parameters¶
This endpoint does not use HTTP request path parameters.
Request Query Parameters¶
Name | Type | Description |
---|---|---|
whitelist | string | The IP address that you want to add to the new user’s whitelist. Note You can add more than one whitelist parameter and value. |
Request Body Parameters¶
Name | Type | Description |
---|---|---|
username | string | Ops Manager username of the new Ops Manager user. Note The |
password | string | Password of the new Ops Manager user. This field is not included in the HTTP response body. It can only be sent in the HTTP request when creating a new user. |
emailAddress | string | (Optional.) Email address of the new Ops Manager user. |
firstName | string | First name of the new Ops Manager user. |
lastName | string | Last name of the new Ops Manager user. |
Response¶
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
emailAddress | string | Email address of the Ops Manager user. | ||||||||||||||||||||||||||||||||||||||||
firstName | string | First name of the Ops Manager user. | ||||||||||||||||||||||||||||||||||||||||
id | string | Unique identifier of the Ops Manager user. | ||||||||||||||||||||||||||||||||||||||||
lastName | string | Last name of the Ops Manager user. | ||||||||||||||||||||||||||||||||||||||||
links | object array | Links to related sub-resources. All links arrays in
responses include at least one link called self. The
relations between URLs are explained in the Web Linking
Specification. |
||||||||||||||||||||||||||||||||||||||||
mobileNumber | string | Mobile number of the Ops Manager user. | ||||||||||||||||||||||||||||||||||||||||
roles | object array | Role assignments. | ||||||||||||||||||||||||||||||||||||||||
roles.groupId | string | Unique identifier for the project in which the user has the specified role. For the “global” roles (those whose name starts
with |
||||||||||||||||||||||||||||||||||||||||
roles.orgId | string | Unique identifier for the organization in which the user has the specified role. | ||||||||||||||||||||||||||||||||||||||||
roles.roleName | string | Name of the role. Accepted values are:
|
||||||||||||||||||||||||||||||||||||||||
username | string | Ops Manager username of the Ops Manager user. |