Function prototype

user_insert ( session, user [, team])

API Version

All

The format of the response changed in version 2.7.12. See Response format prior to version 2.7.12 for additional information

Creates a new user If a Team is provided, the new USER will be added as member od that team
Input parameters:	*session: a token obtained by calling session_init () user: a user xml identifier/value: id refs to external sources (i.e. radius authentication systems) data: user data preferences* password (optional): If not provided, the password assigned to the new account of the USER will be the default password configured for the instance (see WEB SERVICES CONFIGURATION). Introduced in API Version 2.7.19 password_expire: (true / false): If true, the system will request a password change on the next login (session_init ()) nickname: an optional “alias” for the user contact: user contact data. See user_get_contact () and user_set_contact () username: Linkcare’s user name for login pruposes bdate: birthday date addresses: list of addresses - optinal(can be updated calling user_set_contact) channels: list of contact channels (email, phone) - optinal(can be updated calling user_set_contact) team: reference to a team. If no team is specified, the active team in the specified session would be used
Output parameters:	result: XML with information about the execution of the function: user: reference to the new USER created or empty if any error occurred type: ("NEW" / "EXIST") If the operation was successful, indicates whether a new CASE was created or a existing one that matched the information was used validation: This information is generated only if an error of type CONTACT_DATA.VALIDATION happens. See CONTACT DATA VALIDATION for a detailed explanation of the validation information ErrorMsg: any fault in the call, either in the validation of input parameters, errors in the connection to the database or any other error, this parameter returns the error message produced ErrorCode: If any error occurs, then this value contains any of the standard ERROR CODES
Request sample:	user_insert ( “LCAAAAAAAAAAAA”, <?xml version="1.0" encoding="utf-8" standalone="yes"?> <user> <ref></ref> <name> <given_name>supermember</given_name> <family_name></family_name> </name> <identifiers> <identifier> <label>NICKNAME</label> <value>supermember</value> </identifier> <identifier> <label>NAT_ES</label> <value>supermember</value> </identifier> <identifier> <label>PASS</label> <value>supermember</value> </identifier> </identifiers> <data> <bdate>1996-01-10</bdate> <gender>M</gender> <status></status> <preferences> <team_private>false</team_private> <password>asd8asd!</password> <password_expire>0</password_expire> <editable_by_user>false</editable_by_user> <editable_by_team_manager>true</editable_by_team_manager> </preferences> </data> <addresses> <address> <kind>Main Address</kind> <street>Sepúlveda</street> <number>91</number> <floor>5º</floor> <suite>3ª</suite> <district /> <city>Barcelona</city> <postcode /> <state /> <country>España</country> <comment /> </address> </addresses> <channels> <phones> <phone> <ref>1</ref> <type>mobile</type> <value>934546365</value> <comment /> <preferred>true</preferred> </phone> <phone> <ref>2</ref> <type>ext</type> <value>22</value> <comment /> <preferred>false</preferred> </phone> <phone> <ref>3</ref> <type>home</type> <value>936666666</value> <comment /> <preferred>false</preferred> </phone> <phone> <ref>4</ref> <type>work</type> <value>935555555</value> <comment /> <preferred>false</preferred> </phone> </phones> <emails> <email> <ref>5</ref> <type>work</type> <value>adsasda@LINKCARE.ES</value> <comment /> <preferred>true</preferred> </email> <email> <ref>6</ref> <type>home</type> <value>awasdasd@LINKCARE.ES</value> <comment /> <preferred>false</preferred> </email> </emails> <aims> <aim> <ref>7</ref> <type>Skype</type> <value>SKYPEUSER</value> <comment /> </aim> </aims> <device> <ref>8</ref> <type>bluetooth</type> <value>D898989</value> <comment /> </device> <devices /> </channels> </user> ”, 1)
Response sample:	<?xml version="1.0" encoding="utf-8" standalone="yes"?> <result> <user_insert> <user>1234</user> <type>NEW<type> <validation></validation> </user_insert> </result> <ErrorMsg></ErrorMsg> <ErrorCode></ErrorCode>
Notes:	This function replaces user_insert ( session, user ) and team_user_insert (session, user, team)

Return Error codes

ERROR CODE
INVALID_TOKEN	The session token provided is not valid
XML_ERROR	The information provided for creating the CASE does not have a valid XML format
INSUFFICIENT_PRIVILEGES	The session user does not have the necessary privileges to create an ADMISSION in the SUBSCRIPTION or the TEAM reference provided is not a member of the SUBSCRIPTION
TEAM.NOT_FOUND	The TEAM provided was not found
CONTACT_DATA.VALIDATION	The information provided to validate the CASE is not valid

Response format in version prior to version 2.7.12

The XML response generated in previous versions was the following

result: reference to the new USER created or empty if any error occurred
type: ("NEW" / "EXIST") If the operation was successful, indicates whether a new USER was created or a existing one that matched the information was used
ErrorMsg: any fault in the call, either in the validation of input parameters, errors in the connection to the database or any other error, this parameter returns the error message produced
ErrorCode: If any error occurs, then this value contains any of the standard ERROR CODES

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<result>user_id</result>
<type>NEW</type>
<ErrorMsg></ErrorMsg>

Browser not supported