Users exist in a domain and are provisioned to projects within that domain.

Only a domain admin can call this resource. NOTE: You must be a domain admin to create a user.

In the request body, specify the following mandatory parameters:

• login (string in the format of an email address) is the user login. Once created, this property cannot be updated.

  The login must be a string in the format of an email address but does not have to be an actual working email address.

  You can generate logins from unique user IDs used on your site (for example, 123456@gd.example.com, 234567@gd.example.com, and so on). For receiving emails sent by GoodData (such as notifications or scheduled emails), set the user's email via the optional email parameter (see further in this section).

  The login is case-sensitive and must be written in lowercase.

  • Correct: john.doe@example.com

  • Incorrect: John.Doe@example.com

• firstName (string) is the user's first name.

• lastName (string) is the user's last name.

Additionally, you can specify the following optional parameters:

• email (string) is the user's contact email. The email can (but does not have to) be the same as the login. If the email is not specified, it will be filled by the login parameter. The email does not have to be unique within the domain.

• ssoProvider (string) is the identifier of the user's authentication provider. It can contain a single value or a comma-separated list of values (for example, "ssoProvider": "sso_provider_1, sso_provider_2").

  The identifier that you are providing must exist in the GoodData platform (see Set up User Authentication and SSO). Otherwise, the API call fails.

• authenticationModes (array of strings) is authentication mode (SSO, PASSWORD, or both) allowed for the user. If specified, the value of this field overrides authentication mode set globally for the domain.

• companyName (string) is the name of the company where the user works.

• position (string) is the user's job position in the company.

• country (string) is the country where the user is located.

• phoneNumber (string) is the user's phone number.

• timezoneName (string) is the timezone where the user belongs to. The timezone must be in the format specified in the IANA Time Zone Database. If set, the user's timezone overrides the timezone set for the project.

  NOTE: The timezone property is deprecated and not used.

• language (string in the format of the IETF language tags) is the language used in the embedded dashboards that the user can view. If not set, defaults to English (en-US). Other available languages are Dutch (nl-NL), Spanish (es-ES), Portuguese/Brazil (pt-BR), Portuguese/Portugal (pt-PT), French (fr-FR), German (de-DE), Japanese (ja-JP), and Simplified Chinese (zh-Hans).

• ipWhitelist (array of strings in the CIDR format) is the IP address ranges, from which the user is allowed to access the GoodData platform.

  • When set to an array of IP addresses, ipWhitelist overrides any domain IP whitelist settings that may have been set.

  • When set to null or not set, the domain IP whitelist settings are applied.

  • When set to an empty array ([]), the user has no access to the GoodData platform.

• password (string) and verifyPassword (string) are the user's password; must be used together and set to the same password.

  You do not have to provide passwords, and we do not recommend that you provide them.

  When not provided, the password is generated automatically, and either the user can change it when logging in to the GoodData platform for the first time, or the password can be set with SSO.

  If you want to set the password for the user, specify both the password and verifyPassword and set both of them to the same password.

  For more information about passwords, see Password Policy.

For detailed information about all user properties, see User Properties.

{
  "accountSetting": {
    "login": "user@example.com",
    "email": "user@example.com",
    "firstName": "First Name",
    "lastName": "Last Name",
    "companyName": "Company Name",
    "position": "Data Analyst",
    "created": "2020-01-08 15:44:23",
    "updated": "2020-01-08 15:44:23",
    "timezone": 100,
    "timezoneName": "Europe/Prague",
    "country": "United States",
    "phoneNumber": "(425) 555-1111",
    "old_password": "secret$123",
    "password": "secret$234",
    "verifyPassword": "secret$234",
    "ssoProvider": "sso-domain.com",
    "language": "en-US",
    "ipWhitelist": [
      "127.0.0.1"
    ],
    "links": {
      "projects": "/gdc/account/profile/{profile_id}/projects",
      "self": "/gdc/account/profile/{profile_id}"
    }
  }
}

{
  "uri": "/gdc/uri"
}