DocumentationDynamic Media Image Production System API

addUser

Last update: March 9, 2022
  • Topics:
  • Dynamic Media Classic,SDK/API

CREATED FOR:

  • Developer
  • Admin

Creates a user account and adds that account to one or more companies.

When adding a user to multiple companies, specify those companies by their company handles in companyHandleArray. This operation returns the handle to user you just added.

Authorized User Types

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parameters

Input (addUserParam)

NameTypeRequiredDescription
firstNamexsd:stringYesThe user’s first name.
lastNamexsd:stringYesThe user’s last name.
emailxsd:stringYesThe user’s email address.
defaultRolexsd:stringYesSets the role for a user in each company they belong to. Note, however, the IpsAdmin role overrides other per-company settings.
passwordxsd:stringYesSets the user’s password
passwordExpiresxsd:dateTimeNoSets the password expiration period. Provide the time zone when passing in the request. Time zones are adjusted to Central Time.
isValidxsd:booleanYesDetermines if the user is valid.
membershipArrayxsd:CompanyMembershipUpdateArrayYesAn array of company handles.

Output (addUserParam)

NameTypeRequiredDescription
userHandlexsd:stringYesThe handle to the user.

Examples

The IPS API returns a user handle element that specifies the new user.

Request

<ns1:addUserParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:firstName>Joe</ns1:firstName>
   <ns1:lastName>User</ns1:lastName>
   <ns1:email>juser@adobe.com</ns1:email>
   <ns1:defaultRole>TrialSiteUser</ns1:role>
   <ns1:password>passw0rd</ns1:password>
   <ns1:isValid>true</ns1:isValid>
   <ns1:companyHandleArray>
      <ns1:items>47</ns1:items>
   </ns1:companyHandleArray>
</ns1:addUserParam>

Response

<ns1:addUserReturn xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:userHandle>525s|juser@scene7.com</ns1:userHandle>
</ns1:addUserReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681