Welcome!  English (US) Language Switcher


Creates a new group.


This method requires authentication with write permissions.


This method requires a timeline.


api_key (Required)
Your API application key. See here for more details.
timeline (Required)
The timeline within which to run a method. See here for more details.
group (Required)
The name of the group to create.

Example Response

<group id="987654321" name="Friends">
  <contacts />

Error Codes

98: Login failed / Invalid auth token
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.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
114: Invalid SOAP envelope
The SOAP envelope sent in the request could not be parsed.
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.
300: Timeline invalid or not provided
No timeline provided / Timeline invalid.
2000: Group name provided is invalid.
The group name provided is invalid.
2010: Group provided already exists.
User already has a group with this name.