Skip to main content
Planview Customer Success Center

Create a user

POST /io/user

Creates a new user.

Requires account administrator access.

Request Properties

Param Type Usage Default
emailAddress* string
firstName* string
lastName* string
password* string
timeZone string See valid timezones. Etc/GMT
enabled boolean true
administrator boolean false
boardCreator boolean false
dateFormat string MM/dd/yyyy, dd/MM/yyyy, or yyyy/MM/dd MM/dd/yyyy
licenseType enumeration Only available if reader users are enabled for the account. Possible values:
externalUserName string

Minimal Request

  "emailAddress": "",
  "firstName": "Some",
  "lastName": "One",
  "password": "supersecurepassword1"

Example Successful Response

200 Success

  "id": "10113041625",
  "username": "",
  "firstName": "Some",
  "lastName": "One",
  "fullName": "Some One",
  "emailAddress": "",
  "lastAccess": null,
  "dateFormat": "MM/dd/yyyy",
  "administrator": false,
  "enabled": true,
  "deleted": false,
  "organizationId": "10187654101",
  "boardCreator": false,
  "timeZone": "Etc/GMT",
  "licenseType": "full",
  "externalUserName": null,
  "avatar": "",
  "settings": {},
  "boardRoles": [
          "boardId": "10100000505",
          "WIP": null,
          "role": {
              "key": "boardReader",
              "value": 1,
              "label": "Reader"

Response Properties

Property Type Note
id string id
username string
firstName string
lastName string
fullName string
emailAddress string
lastAccess date
dateFormat string
administrator boolean
enabled boolean
deleted boolean
organizationId string
boardCreator boolean
timeZone string
licenseType string full or reader. Only present if reader is enabled for the account
externalUserName string
avatar string
settings object Contains a key/value hash of user settings
boardRoles array Contains the user's access information for the organization's boards

Updated 2023-04-11 @ 16:04 PM