Create Company User
post
/rest/v16/companies/{companyName}/users
This operation creates a new user.
Request
Supported Media Types
- application/json
Path Parameters
-
companyName(required): string
Company login name. For Host Company users, use _host. For Partner Organization users, use partner organization company login name.
Root Schema : User request model
Type:
object
Title:
User request model
Request for creating a user
Show Source
-
active:
boolean
Title:
User status
Status of the User -
emails(required):
array Email
Title:
Email
Email of the User -
enterpriseUser(required):
object enterpriseUser
-
extensionUser(required):
object extensionUser
-
name(required):
object Name
Title:
Name
Full name of the user -
phoneNumbers:
array Phone Numbers
Title:
Phone Numbers
Phone numbers of the User -
preferredLanguage:
string
Title:
Preferred Language
Preferred language of the User -
timezone:
string
Title:
timezone
Time zone of the user -
title:
string
Title:
Job title of the User
Job title of the User -
userName(required):
string
Title:
Username
Login Name of the user
Nested Schema : enterpriseUser
Type:
Show Source
object
-
organization(required):
string
Title:
Organization
Company name of the user
Nested Schema : extensionUser
Type:
Show Source
object
-
addresses:
array addresses
-
approvalDelegate:
string
Title:
Approval Delegate
Approval Delegate -
currency:
string
Title:
Currency Code
Preferred Currency Code of the user -
dateFormat:
integer
Title:
Date Format Id
Date Format Id -
enabledForSso:
string
Title:
Enabled For SSO
Enabled For SSO -
externalSsoId:
string
Title:
externalSsoId
External SSO Id -
fax:
string
Title:
Fax Number
Fax of the user -
isAccessAdminPermEnabled:
boolean
Title:
Access Admin Permission Enabled
Access Admin Permission Enabled -
isNotifyEmail:
boolean
Title:
Is Notification Preference Email
Is Notification Preference Email -
isNotifyFax:
boolean
Title:
Is Notification Preference Fax
Is Notification preference Fax -
isProxyPermEnabled:
boolean
Title:
Proxy permission enabled
Proxy permission enabled -
isSuperUserPermEnabled:
boolean
Title:
Is Superuser Permission Enabled
Is Superuser Permission Enabled -
isWebServicesOnly:
boolean
Title:
Web Services Only
Web Services Only -
numberFormat:
integer
Title:
Number Format Id
Number Format Id -
partnerLogin:
string
Title:
Partner Login
Partner Login of the user -
SeparateShipAddr:
boolean
Title:
Separate ship address
Separate ship address -
sfdcOrgId:
string
Title:
Sfdc Organization ID
Sfdc Organization ID -
units:
integer
Title:
Units
Units -
userType:
string
Title:
Type of the user
Type of the user
Nested Schema : Name
Type:
object
Title:
Name
Full name of the user
Show Source
-
familyName:
string
Title:
FamilyName
Last Name of the user -
givenName(required):
string
Title:
GivenName
First name of the user
Nested Schema : Phone Numbers
Type:
array
Title:
Phone Numbers
Phone numbers of the User
Show Source
Nested Schema : email
Type:
Show Source
object
-
primary:
boolean
Title:
primary
Whether email is primary or not -
type:
string
Title:
type
Type of the email -
value(required):
string
Title:
value
value of the email
Nested Schema : address
Type:
Show Source
object
-
address1:
string
Title:
Shipping/Billing Address 1
Shipping/Billing Address 1 -
address2:
string
Title:
Shipping/Billing Address 2
Shipping/Billing Address 2 -
companyName:
string
Title:
Shipping/Billing Company
Shipping/Billing Company -
companyName2:
string
Title:
Shipping/Billing Company2
Shipping/Billing Company2 -
country:
string
Title:
Shipping/Billing Country
Shipping/Billing Country -
email:
string
Title:
Shipping/Billing Email
Shipping/Billing Email -
fax:
string
Title:
Shipping/Billing Fax
Shipping/Billing Fax -
locality:
string
Title:
Shipping/Billing Locality
Shipping/Billing Locality -
name:
object Shipping/Billing Full name
Title:
Shipping/Billing Full name
Shipping/Billing Full name -
phone:
string
Title:
Shipping/Billing Phone
Shipping/Billing Phone -
postalCode:
string
Title:
Shipping/Billing Postal Code
Shipping/Billing Postal Code -
region:
string
Title:
Shipping/Billing Region
Shipping/Billing Region -
type:
string
Title:
Address Type
Allowed Values:[ "BILL_TO", "SHIP_TO" ]
Address Type
Nested Schema : Shipping/Billing Full name
Type:
object
Title:
Shipping/Billing Full name
Shipping/Billing Full name
Show Source
-
familyName:
string
Title:
Shipping/Billing FamilyName
Shipping/Billing FamilyName -
givenName:
string
Title:
Shipping/Billing GivenName
Shipping/Billing GivenName
Nested Schema : phoneNumber
Type:
Show Source
object
-
primary:
boolean
Title:
primary
Whether phone number is primary or not -
type:
string
Title:
type
Type of the phone number -
value:
string
Title:
value
value of the phone number
Response
Supported Media Types
- application/json
Default Response
Created User details
Root Schema : user
Type:
Show Source
object
-
accessPermissions:
object Access Permissions
Title:
Access Permissions
Access Permissions of a user -
approvalDelegate:
string
Title:
Approval Delegate
Approval Delegate -
billAddress1:
string
Title:
Billing Address 1
Billing Address 1 -
billAddress2:
string
Title:
Billing Address 2
Billing Address 2 -
billCity:
string
Title:
Billing City
Billing City -
billCompany:
string
Title:
Billing Company
Billing Company -
billCompany2:
string
Title:
Billing Company 2
Billing Company 2 -
billCountry:
string
Title:
Billing Country
Billing Country -
billEmail:
string
Title:
Billing Email
Billing Email -
billFax:
string
Title:
Billing Fax
Billing Fax -
billFirstName:
string
Title:
Billing First Name
Billing First Name -
billLastName:
string
Title:
Billing Last Name
Billing Last Name -
billPhone:
string
Title:
Billing Phone
Billing Phone -
billStateProvince:
string
Title:
Billing State
Billing State -
billZip:
string
Title:
Billing Zip
Billing Zip -
company:
object Company details
Title:
Company details
User Company details. Applicable only for Users Across Companies -
currency:
object Currency
Title:
Currency
Currency preference of user. Value holds currency code -
dateAdded:
string
Title:
Date Added
User creation date -
dateFormat:
object Date Format
Title:
Date Format
User preferred date time format -
dateModified:
string
Title:
Date Modified
User modified date -
email:
string
Title:
Email
Email of the user -
enabledForSso:
object Enabled For SSO
Title:
Enabled For SSO
Enabled For SSO -
externalSsoId:
string
Title:
External SSO Id
External SSO Id -
fax:
string
Title:
Fax Number
Fax of the user -
firstName:
string
Title:
First Name
First Name of the user -
groups:
object Groups
Title:
Groups
Groups to which the user belongs -
isAccessAdminPermEnabled:
boolean
Title:
Access Admin Permission Enabled
Access Admin Permission Enabled -
isMobileEnabled:
boolean
Title:
Is Mobile Enabled
Is Mobile Enabled -
isNotifyEmail:
boolean
Title:
Is Notification Preference Email
Is notification preference email -
isNotifyFax:
boolean
Title:
Is Notification Preference Fax
Is notification preference fax -
isProxyPermEnabled:
boolean
Title:
Proxy Permission Enabled
Proxy permission enabled -
isSuperUserPermEnabled:
boolean
Title:
Is Superuser Permission Enabled
Is Superuser Permission Enabled -
isWebServicesOnly:
boolean
Title:
Web Services Only
Web Services Only -
jobTitle:
string
Title:
Job Title
Job Title of the user -
language:
object Language
Title:
Language
Language preference of user. Value holds language code -
lastLogin:
string
Title:
Last Login Date
User last loggedin date -
lastName:
string
Title:
Last Name
Last Name of the user -
links:
array Links to the related objects
Title:
Links to the related objects
Links to the related objects -
login:
string
Title:
Login Id
Login Id of the user -
numberFormat:
object Number Format
Title:
Number Format
Preferred number format of user -
partnerLogin:
string
Title:
Partner Login
Partner Login -
phone:
string
Title:
Phone Number
Phone number of the user -
separateShipAddr:
boolean
Title:
Seperate Ship Address
Seperate Ship Address -
shipAddress1:
string
Title:
Shipping Address 1
Shipping Address 1 -
shipAddress2:
string
Title:
Shipping Address 2
Shipping Address 2 -
shipCity:
string
Title:
Shipping City
Shipping City -
shipCompany:
string
Title:
Shipping Company
Shipping Company -
shipCompany2:
string
Title:
Shipping Company 2
Shipping Company 2 -
shipCountry:
string
Title:
Shipping Country
Shipping Country -
shipEmail:
string
Title:
Shipping Email
Shipping Email -
shipFax:
string
Title:
Shipping Fax
Shipping Fax -
shipFirstName:
string
Title:
Shipping First Name
Shipping First Name -
shipLastName:
string
Title:
Shipping Last Name
Shipping Last Name -
shipPhone:
string
Title:
Shipping Phone
Shipping Phone -
shipStateProvince:
string
Title:
Shipping State
Shipping State -
shipZip:
string
Title:
Shipping Zip
Shipping Zip -
status:
object Status
Title:
Status
Status of the user -
timeZone:
object TimeZone of user
Title:
TimeZone of user
User preferred timezone -
type:
object Type
Title:
Type
Type of the user -
units:
object Units
Title:
Units
User preferred units
Nested Schema : Access Permissions
Type:
object
Title:
Access Permissions
Access Permissions of a user
Show Source
Nested Schema : Company details
Type:
object
Title:
Company details
User Company details. Applicable only for Users Across Companies
Show Source
-
loginName:
string
Title:
Company Login Name
Company Login Name -
name:
string
Title:
Company Name
Company Name
Nested Schema : Currency
Type:
object
Title:
Currency
Currency preference of user. Value holds currency code
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
string
Title:
Value
Value
Nested Schema : Date Format
Type:
object
Title:
Date Format
User preferred date time format
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
number
Title:
Value
Value
Nested Schema : Enabled For SSO
Type:
object
Title:
Enabled For SSO
Enabled For SSO
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
string
Title:
Value
Value
Nested Schema : Language
Type:
object
Title:
Language
Language preference of user. Value holds language code
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
string
Title:
Value
Value
Nested Schema : Links to the related objects
Type:
array
Title:
Links to the related objects
Links to the related objects
Show Source
-
Array of:
object reference links
Title:
reference links
Reference links for the Parent, Self, Children and Related as applicable
Nested Schema : Number Format
Type:
object
Title:
Number Format
Preferred number format of user
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
number
Title:
Value
Value
Nested Schema : Status
Type:
object
Title:
Status
Status of the user
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
string
Title:
Value
Value
Nested Schema : TimeZone of user
Type:
object
Title:
TimeZone of user
User preferred timezone
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
number
Title:
Value
Value
Nested Schema : Type
Type:
object
Title:
Type
Type of the user
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
string
Title:
Value
Value
Nested Schema : Units
Type:
object
Title:
Units
User preferred units
Show Source
-
displayValue:
string
Title:
Display Value
Display value. -
value:
number
Title:
Value
Value
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Access Permission
Title:
Access Permission
User access bits information
Nested Schema : Access Permission
Type:
object
Title:
Access Permission
User access bits information
Show Source
-
hasAccess:
boolean
Title:
Has Access
Boolean attribute that indicates if a user has access to the restricted entity. -
name:
string
Title:
Restricted Entity Name
Name of the entity to which access restrictions apply -
type:
string
Title:
Type
Type of the restricted entity. Possible values productFamily, supportedProductFamily and dataTableFolder -
variableName:
string
Title:
Restricted Entity Variable Name
Variable name of the entity to which access restrictions apply
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Group
Title:
Group
User group information
Nested Schema : Group
Type:
object
Title:
Group
User group information
Show Source
-
label:
string
Title:
Group Name
Group name -
type:
string
Title:
Group Type
Type of the group -
variableName:
string
Title:
Group Variable Name
Variable name of the group
Nested Schema : reference links
Type:
object
Title:
reference links
Reference links for the Parent, Self, Children and Related as applicable
Show Source
-
href:
string
Title:
URL to the related object
URL to the related object -
name:
string
-
rel:
string
Title:
Link Relationship to the current object
Default Value:self
Link Relationship to the current object
Examples
The following example shows how to operation creates a new user by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X POST - i - H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" - H "Content-type: application/json" https://sitename.oracle.com/rest/v16/companies/_host/users
Request Body Sample
{ "login": "johnsmith", "firstName": "John", "lastName": "Smith", "jobTitle": "Sales Administrator", "password": "password1234", "emailPassword": true, "email": "john.smith@companyemail.com", "phone": "2346456456", "fax": "456457657", "billLastName": "test", "billCompany": "A", "billCompany2": "test", "billAddress1": "Address1", "billAddress2": "Address2", "billCity": "City", "billStateProvince": "Illinois", "billZip": "23434", "billCountry": "United States", "billPhone": "457657657", "billFax": "657657", "billEmail": "john.smith@companyemail.com", "shipFirstName": "Super", "shipLastName": "User", "shipCompany": "B", "shipCompany2": "B", "shipAddress1": "Address", "shipAddress2": "Address", "shipCity": "City", "shipStateProvince": "California", "shipZip": "345435", "shipCountry": "United States", "shipPhone": "345435", "shipFax": "235435", "shipEmail": "john.smith@companyemail.com", "partnerLogin": null, "separateShipAddr": false, "isNotifyEmail": true, "isNotifyFax": false, "numberFormat": { "value": 1, "displayValue": "####,##" }, "timeZone": { "value": "America/Los_Angeles", "displayValue": "(GMT-8:00 GMT-7:00) Los Angeles" }, "type": { "value": "FULL_ACCESS", "displayValue": "FullAccess" }, "language": { "value": "en_US", "displayValue": "English" }, "currency": { "value": "USD", "displayValue": "US Dollar" }, "dateFormat": { "value": 16, "displayValue": "dd/MM/yyyy h:mm a" }, "status": { "value": 1, "displayValue": "Active" }, "enabledForSso": { "value": "SSO_ENABLED", "displayValue": "Enabled for SSO" }, "groups": { "items": [{ "label": "Sales Administrator", "variableName": "salesAdministrator", "type": "Sales" } ] }, "accessPermissions": { "items": [{ "name": "Testbed", "variableName": "testbed", "hasAccess": true, "type": "productFamily" } ] } }