group.add [HTTP POST]
Add a new group to the database. This method requires authentication.
Arguments
api_key (Required)
Your API application key. If you don't have one,
create one.
token (Required)
An authentication token. (
What's this?)
name (Required)
The name of the group.
description (Optional)
The group's description. May contain some HTML.
event_moderation (Numeric, either 1 or 0)
Whether to enable moderation of event suggestions. Default is 0.
member_moderation (Numeric, either 1 or 0)
Whether to enable moderation of new members. Default is 0.
is_private (Number, 1 or 0)
Indicates whether it should be a private, invite-only group(1), or
available for public view and searching (0).
Example Response (returns the details for the group you added)
<?xml version="1.0" encoding="UTF-8"?>
<rsp stat="ok" version="1.0">
<group id="2949" name="Gordons Group 2"
description="I like <b>Bold Tags</b> and <a href="http://getluky.net">links</a>"
event_moderation="1" member_moderation="1" is_private="1" topic_count="0"
member_count="1" timestamp="2007-06-06 16:48:25" owner_user_id="10708"
commercial_account_id="0" />
</rsp>
Error Codes (sent in HTTP Response Header)
403 Not Authorized:
- Missing valid authentication parameters - Please pass an authentication token to the method.
- Invalid authentication parameters - either that token was not found, or it may be deactivated. Please contact us for support.
409 Conflict:
- Missing valid api_key - Please create an API key using the above link.
- Your api_key is inactive or not found - Please contact us for support.
- Missing user_id parameter.
- Invalid name parameter.
- Duplicate group exists with that name - please choose a different name.