API Methods


Set a 3jam user's preferences. getPreferences is used to get preferences.


Authentication with a 3jam user's mobile phone number and password is required


api_key (required)
api_version (required)
mobile (required)
Mobile number of 3jam user you're requesting friends for
password (required)
md5 the concatenation of the mobile number and 3jam password for this user. e.g. in PHP: md5($mobile . $password)
firstname (optional)
First name to set for this user
lastname (optional)
Last name to set for this user
newAvatarURL (optional)
Avatar (picture) URL
date_of_birth_year (optional)
Birthday year
date_of_birth_month (optional)
Birthday month
date_of_birth_day (optional)
Birthday day
gender (optional)
Gender (male or female)
zipcode (optional)
5-digit Zip Code


<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
  <user user_id="25678" firstname="Charlie" lastname="Brown" />

Error Codes

98: Login failed
The login details or auth token passed were invalid.
100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
601: Invalid first name
The first name provided is invalid (a specific reason will be returned).
602: Invalid last name
The last name provided is invalid (a specific reason will be returned).