Create a User
post
/api/restapi/user
Send a request to this endpoint to create a user.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : ApiEntityUserInput
Type:
object
Title:
Show Source
ApiEntityUserInput
-
companyId(required): integer
(int64)
The system-generated identifier of a company.
-
email(required): string
Maximum Length:
255
The email address of a user. -
federatedUser: boolean
Indicates whether to create a federated user.
Default value is false. -
firstName(required): string
Maximum Length:
150
The first name of a user. -
globalProfileId: string
The unique identifier for the global permission set.
-
lastName(required): string
Maximum Length:
150
The last name of a user. -
mobile: string
Maximum Length:
20
The mobile phone number of a user. -
officeIds(required): array
officeIds
The list of unique identifiers for the offices.
-
phone: string
Maximum Length:
20
The phone number of a user. -
productNames: array
productNames
The list of license names.
-
title: string
Maximum Length:
200
The title of a user. -
useExistingUser: boolean
Determines whether to reuse an existing user.
Default value is true. -
userLocale(required): string
The language code for a user.
pt_BR
- Brazilian Portuguesenl
- Dutchen
- Englishfr
- Frenchde
- Germanit
- Italianja
- Japaneseko
- Koreanru
- Russianzh_CN
- Simplified Chinesees
- Spanishzh_TW
- Traditional Chinese
-
userType: string
Allowed Values:
[ "USER", "COMPANY_RESTRICTED", "APPLICATION_ADMIN", "IDEA_SUBMITTER" ]
The type of the user.
Nested Schema : productNames
Type:
array
The list of license names.
Allowed Values:
Show Source
[
"PORTFOLIO",
"PROGRESS",
"SCHEDULE",
"TASKS"
]
-
Array of:
string
Allowed Values:
[ "PORTFOLIO", "PROGRESS", "SCHEDULE", "TASKS" ]
Examples
Back to Top
Response
Supported Media Types
- application/json
201 Response
The object was successfully created.
Root Schema : ApiEntityUser
Type:
object
Title:
Show Source
ApiEntityUser
-
companyId: integer
(int64)
The company the user is associated with.
-
email: string
Maximum Length:
255
The email address of a user. -
federatedUser: boolean
Indicates if the user is a federated user.
-
firstName: string
Maximum Length:
150
The first name of a user. -
globalProfileId: string
The unique identifier for the global permission set.
-
lastName: string
Maximum Length:
150
The last name of a user. -
ldapGuid: string
Minimum Length:
1
Maximum Length:255
The unique identifier in the external authentication system (LDAP or IDCS). -
mobile: string
Maximum Length:
20
The mobile phone number of a user. -
officeIds: array
officeIds
The list of unique identifiers for the offices.
-
phone: string
Maximum Length:
20
The phone number of a user. -
restrictedUser: boolean
Indicates that the user can only access records associated with the assigned company.
-
title: string
Maximum Length:
200
The title of a user. -
userId: integer
(int64)
The system-generated identifier of a user.
-
userLocale: string
The language code for a user.
pt_BR
- Brazilian Portuguesenl
- Dutchen
- Englishfr
- Frenchde
- Germanit
- Italianja
- Japaneseko
- Koreanru
- Russianzh_CN
- Simplified Chinesees
- Spanishzh_TW
- Traditional Chinese
-
userName: string
Maximum Length:
255
The identification used by a user to log in to the system. -
userProducts: array
userProducts
A list of all user product fields and values in the form of key value pairs.
-
userSettings: array
userSettings
A list of all user setting fields and values in the form of key value pairs.
-
userType: string
Allowed Values:
[ "USER", "COMPANY_RESTRICTED", "APPLICATION_ADMIN", "IDEA_SUBMITTER" ]
The type of the user.
Nested Schema : userProducts
Type:
array
A list of all user product fields and values in the form of key value pairs.
Show Source
-
Array of:
object ApiEntityUserProduct
Title:
ApiEntityUserProduct
Nested Schema : userSettings
Type:
array
A list of all user setting fields and values in the form of key value pairs.
Show Source
-
Array of:
object ApiEntityApplicationUserSetting
Title:
ApiEntityApplicationUserSetting
Nested Schema : ApiEntityUserProduct
Type:
object
Title:
Show Source
ApiEntityUserProduct
-
applicationUserId: integer
(int64)
The system-generated unique identifier of a user.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
productId: integer
(int64)
The system-generated unique identifier of a license.
-
productName: string
Allowed Values:
[ "IDEA", "PORTFOLIO", "PROGRESS", "SCHEDULE", "TASKS" ]
The name of the license. -
updateDate: string
(date-time)
Date when the record was last updated.
-
userProductId: integer
(int64)
The system-generated identifier for the user product.
Nested Schema : ApiEntityApplicationUserSetting
Type:
object
Title:
Show Source
ApiEntityApplicationUserSetting
-
applicationUserId: integer
(int64)
The system-generated identifier of a user.
-
applicationUserSettingId: integer
(int64)
The unique identifier of a user's settings.
-
link: string
(url)
The self-link to the object. This field is populated only in the responses generated by the batch create APIs.
-
namespace: string
Minimum Length:
1
Maximum Length:255
The namespace to which a user is assigned. -
settingName: string
Allowed Values:
[ "ActivitiesViewSettings", "ActivityNetworkSettings", "ReportsSummaryGridViewConfig", "DecimalPlaces", "NumberDecimalPlaces", "CurrencySymbol", "FourDigitYear", "LeadingZeros", "MonthName", "Separator", "DateFormat", "DigitGroupingSeparator", "DecimalSeparator", "DigitGroupingAndDecimalSymbols", "DigitGroupingStyle", "CurrencyNegativeFormat", "CurrencyPositiveFormat", "TabOrder", "AppVisibilityAndOrder", "ProjectCodesViewConfig", "ProfileImage", "ReportColWidth", "ReportScheduleColWidth", "ScheduleColWidth", "WorkspaceAndProjectDisplayFormat", "AnnouncementsLastReadTime", "LocationsViewConfig", "workflowTasksPrefs", "WorkflowViewLogViewConfig", "monitorWorkflowsPrefs", "startWorkflowsPrefs", "workflowDesignsPrefs", "workflowConfigsPrefs", "monitorWorkflowTasksPrefs", "formTemplatesPrefs", "formPreviewPrefs", "userDashboardPref", "SearchAll", "SearchWorkspaces", "SearchProjects", "SearchScopeItems", "SearchProjectCodes", "SearchGenericPortfolios", "SearchActivities", "SearchDocuments", "SearchUsers", "SearchRisks", "SearchIdeas", "SearchPrograms", "NumberResultsPerSearchResultsPage", "SpatialSearchDefaultUnits", "SpatialSearchDefaultDistance", "SpatialSearchAllProjectsKeywords", "TimeFormat", "DisplayTime", "StatusUpdateActivitySortOrder", "StatusUpdateActivitySortField", "StatusUpdateProjectFilter", "StatusUpdateProjectFilterArray", "StatusUpdateTaskStatusFilter", "StatusUpdateTimeframeFilter", "StatusUpdateWBSFilter", "StatusUpdateFromDateFilter", "StatusUpdateToDateFilter", "ScheduleCheckBeiTarget", "SmLayoutLatestView", "UserAppliedFilterIdList", "ShowMinutes", "DataDateInPageBanners", "ActualDateIndicator", "ConstraintDateIndicator", "ResourceAnalysisDataView", "ResourceAssignmentDataView", "DisplayUnits", "UnitsSubUnits", "UnitsLabel", "UnitsPerTimeFormat", "DisplayDuration", "DurationSubUnits", "DurationLabel", "WhenAssigningResourceToExistingActivity", "WhenResourceAndRoleShareActivityAssignment", "UnitsDecimalPlaces", "UnitsNumberDecimalPlaces", "DurationDecimalPlaces", "DurationNumberDecimalPlaces", "ImportClobberOptions", "HomeRecentsVisible", "UserFirstName", "UserLastName", "UserTitle", "UserLocale", "UserAlternateEmail", "UserPhoneNumber", "UserMobileNumber", "UserFaxNumber", "UserDisplayDensity", "UserTimeZone", "OnboardedForVersion", "WorkPlanGettingStartedShown", "CookiesAcknowledged", "PlaAccepted", "LastSearchIndexRequest", "displayScheduleLog", "LastAccessedWorkPackageId", "LastSearchIndexCompleted", "ExperimentalEnhancedPrint", "ExperimentalColumnMenu", "AutoSaveNamedViews" ]
The name of a user setting. -
settingValue: string
Minimum Length:
1
Maximum Length:4000
The value of a user setting. -
updateDate: string
(date-time)
Date when the record was last updated.
400 Response
Invalid input for the user group service.