API Method: POST member

Invites a new member.

Path:

/api/v2/members.#{format}

Formats:

xml, json

HTTP Method(s):

POST

Parameters:

Note that all parameters are encapsulated within a user array (see example)

• email Required. The email of the user.
• name Required. The name of the user. It will be displayed in the chat.
• jabber_id Optional. The Jabber ID of the user (What is it?).
• job_title Optional. The job title of the user.
• location Optional. The geographical location of the user.
• skype_id Optional. The Skype ID of the user.
• twitter_id Optional. The Twitter ID of the user.
• phone Optional. The phone of the user.
• msn_id Optional. The MSN ID of the user.

Usage examples:

$ curl -u api_token:x -d "user[name]=Mike&user[email]=client@gmail.com" https://bigbang.jaconda.im/api/v2/members.xml

Response:

XML example:

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <created-at type="datetime">2011-02-25T15:49:03+05:00</created-at>
  <email>client@gmail.com</email>
  <id type="integer">36583</id>
  <jabber-id>client@gmail.com</jabber-id>
  <job-title nil="true"></job-title>
  <kind>regular</kind>
  <location nil="true"></location>
  <msn-id nil="true"></msn-id>
  <name>Mike</name>
  <phone nil="true"></phone>
  <skype-id nil="true"></skype-id>
  <twitter-id nil="true"></twitter-id>
  <updated-at type="datetime">2011-02-25T15:49:03+05:00</updated-at>
  <photo-url>https://secure.gravatar.com/avatar/12399f315adaa4c4fcdfabaafc900c7a.png?d=mm&amp;r=PG&amp;s=80</photo-url>
</user>