Update Account Profile

Description

This service provides a way to update the users account profile.

HTTP Method

POST

Path

/account/profile

Authentication

Requires an authenticated user.

Parameters

Table 6.  Parameters for " Update Account Profile "

NameTypeValue TypeDescription
identityIdFORMlongFor new users, this can be provided to update the account profile by another authenticated user, in case all permission checks are met.
langFORMStringThe new lang setting. See data formats.
timezoneFORMStringThe new timezone setting. See data formats.
emailFORMStringUpdate the email address for the account.
aliasFORMStringUpdate the alias for the account.
mobilePhoneFORMStringThe account mobile phone number to be used by the system for SMS notifications. This is a private phone that will not be shared with account's contacts.
countryFORMStringUpdate the country of the account. See data formats.
autoLoginFORMBooleanUpdate the autologin (when launching from the html file).
visibilityFORMStringDefines the profile sharing status (posible values - CONTACTS, EVENT_PARTICIPANTS, PUBLIC)
geolocationEnabledFORMBoolean'true' to enable storing geolocation data for poken interactions
shareActivityFORMBoolean'true' to show your activity updates to other users
tagCollectEnabledFORMBoolean'true' to allow campaign organizers to collect things on this account behalf
emailRecentCollectedFORMStringDefines how often this account should recieve emails with recent collected people and objects (Email frequency values - DAILY, WEEKLY, NO_EMAIL )
emailNetworkUpdatesFORMStringDefines email frequency for account's connections updates (posible values - DAILY, WEEKLY, NO_EMAIL )
emailEventUpdatesFORMBoolean'true' to recieve emails related to the event's the account is part of

Error Codes

10000 ( Account )

An unhandled exception has occured.

10001 ( Account )

This username has already been taken.

10004 ( Account )

The email address provided is already registered.

10010 ( Account )

The identity specified is either invalid or not one of your identites.

10014 ( Account )

The username is too short.It should be at least 2 characters long.

10015 ( Account )

The username contains invalid characters or keywords.

10016 ( Account )

The username contains just numbers.

10017 ( Account )

Invalid email format provided.

10018 ( Account )

You don't have the permission to request such an action.

10021 ( Account )

The country code specified is not a 2 character ISO code.

10025 ( Account )

The timezone specified is invalid.

10026 ( Account )

The language specified is invalid.

10039 ( Account )

Permission denied, not allowed to update this account's profile.

10039 ( Account )

Permission denied, not a new account anymore.

10040 ( Account )

Not a valid account mobile phone provided.

150001 ( Common )

The endpoint requires an authenticated account

Response Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://xsd.poken.com" xmlns:tns="http://xsd.poken.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="response">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="success" type="tns:Status" default="FAILURE" minOccurs="0"/>
        <xs:element name="error" type="tns:Error" nillable="true" minOccurs="0" maxOccurs="unbounded"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

  <xs:complexType name="Error">
    <xs:sequence>
      <xs:element name="code" type="xs:string"/>
      <xs:element name="description" type="xs:string"/>
    </xs:sequence>
  </xs:complexType>

  <xs:simpleType name="Status">
    <xs:restriction base="xs:string">
      <xs:enumeration value="SUCCESS"/>
      <xs:enumeration value="FAILURE"/>
    </xs:restriction>
  </xs:simpleType>
</xs:schema>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://xsd.poken.com">
	<success>SUCCESS</success>
</response>