- 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¶
All fields are required.
Name | Type | Description |
---|---|---|
username | string | Ops Manager username. |
password | string | Password. This field is NOT included in the entity returned from the server. It can only be sent in the entity body when creating a new user. |
emailAddress | string | Email address. |
firstName | string | First name. |
lastName | string | Last name. |
Response¶
Name | Type | Description | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
emailAddress | string | Email address. | ||||||||||||||||||||||||||||||||||||
firstName | string | First name. | ||||||||||||||||||||||||||||||||||||
id | string | Unique identifier. | ||||||||||||||||||||||||||||||||||||
username | string | Ops Manager username. | ||||||||||||||||||||||||||||||||||||
mobileNumber | string | Mobile number. | ||||||||||||||||||||||||||||||||||||
lastName | string | Last name. | ||||||||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||||||||
roles | object array | Role assignments. | ||||||||||||||||||||||||||||||||||||
roles.groupId | string | The ID of the group in which the user has the specified role. For the “global” roles (those whose name starts
with |
||||||||||||||||||||||||||||||||||||
roles.orgId | string | The ID of the organization in which the user has the specified role. | ||||||||||||||||||||||||||||||||||||
roles.roleName | string | The name of the role. Accepted values are:
|