User management API - POST a new user

Creates a new user in your Dynatrace account.

The request consumes an application/json payload.

POST

https://api.dynatrace.com/iam/v1/accounts/{accountUuid}/users

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 OAuth clients.

Parameters

Parameter
Type
Description
In
Required
accountUuid
string

The ID of the required account.

You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client.

path
required
body

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
email
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