User management API - POST a new user
Creates a new user in your Dynatrace account.
The request consumes an application/json payload.
POST |
|
Authentication
To execute this request, you need the Allow write access for identity resources (users and groups) (account-idm-write) scope assigned to your token. To learn how to obtain and use it, see Authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| accountUuid | string | The ID of the required account. You can find the UUID on the Account > Account management API page, during creation of an OAuth client. | path | required |
| body | UserEmailDto | The JSON body of the request. Contains the email address of the new user. | body | required |
Request body objects
The UserEmailDto object
| Element | Type | Description | Required |
|---|---|---|---|
| string | The email address of the user. | required |
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"email": "string"}
Response
Response codes
| Code | Description |
|---|---|
| 201 | Success. The new user has been created. Response doesn't have a body. |
Example
In this example, the request creates an account for a user with james.johnson@company.com email address. The response code of 201 indicates that the creation has been successful.
Curl
curl --request POST \--url 'https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/users' \--header 'Authorization: Bearer abcdefjhij1234567890' \--header 'Content-Type: application/json' \--data '{"email": "james.johnson@company.com"}'
Request URL
https://api.dynatrace.com/iam/v1/accounts/2b794097-8ad2-4b32-b923-0131da2eeddf/users
Request body
"email": "james.johnson@company.com"
Response code
201