Create communities programmatically 

To create a community, send an Atom entry document containing the new community to the My Communities resource.

See Authenticating requests for information about how to authenticate the request.

Table 1. Atom API request details

Method Resource URI Input representation
POST User's My communities feed Value of the href attribute of <collection> element in the Communities Collections workspace with a child <title> that has the value My Communities. community


Provide a community Atom entry document.

Note: The content type of the Atom entry document must be application/atom+xml.



Returned HTTP headers

HTTP/1.1 201 Created

Location: url

Error codes



> POST /communities/service/atom/communities/my HTTP/1.1
> Authorization: Basic xxx > Host: > Accept: */* > Content-Type: application/atom+xml > Content-Length: 920

Content of the MyCommunities.xml file:

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="" xmlns:app="" xmlns:snx=""> <id>ignored</id> <title type="text">Day Care Community</title> <summary type="text">ignored</summary> <content type="html">Share information about day care.</content> <published>ignored</published> <author> <name>John Jordan</name> <email></email> <snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid> <snx:userState>active</snx:userState> </author> <updated>ignored</updated> <contributor> <name>John Jordan</name> <email></email> <snx:userid>50730340-0101-102e-88e1-f78755f7e0ed</snx:userid> <snx:userState>active</snx:userState> </contributor> <category term="community" scheme=""></category> <snx:membercount>ignored</snx:membercount> <snx:communityType>public</snx:communityType> </entry>


< HTTP/1.1 201 Created
< Date: Tue, 10 Aug 2010 20:59:51 GMT < Server: IBM_HTTP_Server < Expires: Thu, 1 Jan 1970 00:00:00 GMT < Cache-Control: no-store, no-cache, must-revalidate < X-LConn-Auth: false < X-UA-Compatible: IE=EmulateIE7 < Last-Modified: Tue, 10 Aug 2010 20:59:51 GMT < Location: ty/instance?communityUuid=35d34540-f36d-4aac-bcd0-9c76c41fe8ee < Set-Cookie: xxx < Set-Cookie: xxx < Set-Cookie: xxx < Content-Length: 0 < Content-Type: text/html < Content-Language: en-US < * Connection #0 to host left intact * Closing connection #0 * SSLv3, TLS alert, Client hello (1):

Parent topic

Work with communities programmatically

Related reference
Community entry content

May 27, 2011 12:02:48 PM


May 27, 2011 12:02:48 PM 1