Register

Use this resource to create an Informatica Intelligent Cloud Services sub-organization. For Informatica Intelligent Cloud Services partners only.

You can create an Informatica Intelligent Cloud Services sub-organization if your organization has the appropriate license and if the user that started the REST API session has the Admin role in the parent organization.

register POST Request

/api/v2/user/register

To create an Informatica Intelligent Cloud Services sub-organization, use the following URI.

Use the session ID from the login response in the request header. Use the serverUrl from the login response as the base URL.
You can use the following attributes in a registration object:

FieldTypeRequiredDescription
orgStringAttribute that defines an Informatica Intelligent Cloud Services organization.
offerCodeStringInclude in the org object.
Offer code assigned to Informatica Intelligent Cloud Services partners...
nameStringInclude in the org object.
Name for the new Informatica Intelligent Cloud Services organization.
address1StringInclude in the org object.
Address where the organization is located.
address2StringInclude in the org object.
Additional address information for the organization.
address3StringInclude in the org object.
City where the organization is located.
cityStringInclude in the org object.
Additional address information for the organization
stateStringInclude in the org object.
State where the organization is located. Use the appropriate state code.
Required for the United States.
For more information, see Appendix A, State codes.
zipcodeStringInclude in the org object.
Country where the organization is located. Use the appropriate country code.
For more information, see Appendix A, Country codes.
countryStringInclude in the org object.
Zip code where the organization is located.
timezoneStringInclude in the org object.
Time zone of the user. Time zone honors Daylight Saving Time.
For more information, see Appendix A , Time zone codes.
employeesStringInclude in the org object.
Time zone of the user. Time zone honors Daylight Saving Time.
For more information, see Appendix A , Time zone codes.
userStringInclude in the user object.
Email address for the organization administrator account.
nameStringInclude in the user object.
Password for the organization administrator account.
passwordStringInclude in the user object.
Last name of the organization administrator.
firstNameStringInclude in the user object.
Phone number for the organization administrator.
lastNameStringInclude in the user object.
Email address that receives notification from Informatica Intelligent Cloud Services.
titleStringInclude in the user object.
Time zone of the organization administrator. Time zone honors Daylight Saving Time.
Use the appropriate time zone code.
For more information, see Appendix A, Time zone codes.
If no valid time zone is passed, Informatica Intelligent Cloud Services uses America/Los_Angeles by default.
phoneStringInclude in the user object.
Security question. Use one of the following codes to select the security question:
SPOUSE_MEETING_CITY
FIRST_JOB_CITY
CHILDHOOD_FRIEND
MOTHER_MAIDEN_NAME
PET_NAME
CHILDHOOD_NICKNAME
CUSTOM_QUESTION:""
emailInclude in the user object.
Answer to the security question
timezone
securityQuestionStringInclude in the user object.
Answer to the security question.
securityAnswerStringInclude in the user object.
Determines if the user must reset the password after the user logs in for the first time. Includes the following values:
True. The user must reset the password.
False. The user is not forced to reset the password.
forceChangePasswordBooleanInclude in the user object.
Whether the user opts in or out of receiving marketing communication from Informatica. TRUE indicates that the user does not want to receive marketing communication.
optOutOfEmailsBooleanInclude in the user object.
Whether the user opts in or out of receiving marketing communication from Informatica. TRUE indicates that the user does not want to receive marketing communication.
registrationCodeStringRegistration code.
sendEmailBooleanWhen registration completes, sends an email to the user email address with temporary login information. Use TRUE to send an email.

POST Response

Returns the user object if the request is successful. Returns the error object if errors occur.
The user object includes the following attributes.

FieldTypeDescription
idStringUser ID.
orgIdStringID of the organization the user belongs to.
6 characters.
orgUuidStringUnique identifier for the organization.
nameStringInformatica Intelligent Cloud Services user name
descriptionStringDescription of the user.
createTimeStringWhen the user account was created.
updateTimeStringWhen the user account was last updated
createdByStringInformatica Intelligent Cloud Services user who created the user account.
updatedByStringInformatica Intelligent Cloud Services user who last updated the user account.
firstNameStringFirst name for the user accoun
lastNameStringLast name for the user account.
titleStringTitle of the user.
phoneStringPhone number for the user.
securityQuestionStringSecurity question. Returns one of the following codes:
SPOUSE_MEETING_CITY
FIRST_JOB_CITY
CHILDHOOD_FRIEND
MOTHER_MAIDEN_NAME
PET_NAME
CHILDHOOD_NICKNAME
CUSTOM_QUESTION:""
securityAnswerStringAnswer to the security question.
rolesStringObject that contains roles assigned to the user.
nameStringIncluded in role object.
Role name. Returns one of the following codes:
SERVICE_CONSUMER
DESIGNER
ADMIN
descriptionStringIncluded in role object.
Role description.
emailStringEmail address to be notified when the user changes the account password.
timezoneStringTime zone of the user. Time zone honors Daylight Saving Time.
For more information, see Time zone codes.
serverUrlStringInformatica Intelligent Cloud Services URL for the organization the user belongs to. Use the serverUrl as a base for most version 2 REST API resource URIs.
spiUrlStringInformatica Cloud Application Integration URL for the organization the user belongs to.
uuIdStringUnique identifier for the user.
icSessionIdStringInformatica Intelligent Cloud Services session ID for version 2 REST API session. Use in most version 2 REST API request headers.
forceChangePasswordBooleanDetermines if the user must reset the password after the user logs in for the first time. Includes the following values:
True. The user must reset the password.
False. The user is not forced to reset the password.

POST Examples

To register an organization in JSON, you might use the following request:

POST https://dm-us.informaticacloud.com/ma/api/v2/user/register 
Content-Type: application/json
Accept: application/json
{
    "@type" : "registration",
    "user" : {
        "@type" : "user",
        "name" : "[email protected]",
        "emails" : "[email protected]",
        "firstName" : "firstName",
        "lastName" : "lastName",
        "title" : "jobTitle",
        "phone" : "(0)1234 567 890",
        "timezone" : null,
        "forceChangePassword" : "true"
        "optOutOfEmails" : "true"
    },
    "org" : {
        "@type" : "org",
        "offerCode" : "PPC30daytrial", 
        "campaignCode" : "PPC",
        "name" : "myOrg",
        "address1" : "1 Main St",
        "city" : "Mycity",
        "state" : "CA",
        "zipcode" : "90210",
        "country" : "US",
        "employees" : "5001_"
    },
    "registrationCode" : "ics-standard", 
    "sendEmail" : true
}

A successful request returns the user object that was created, which includes the organization ID for the organization that was created.