POST api/v2.0/Communities/JoinCommunity?communityKey={communityKey}
Joins the current user to the Community identified by the specified Community Key.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| communityKey |
Unique Identifier of a Community. |
globally unique identifier |
Required |
Body Parameters
None.
Response Information
Resource Description
Data representation of the Joined Community, if the request is successful. Returns
Community| Name | Description | Type | Additional information |
|---|---|---|---|
| AllowMemberCreatedEvents | boolean |
None. |
|
| AllowTickets | boolean |
None. |
|
| CanMembersInviteOthers | boolean |
None. |
|
| CommunityKey | globally unique identifier |
None. |
|
| LegacyGroupKey |
Unique Identifier for this Community in the source system. |
string |
None. |
| CommunityName | string |
None. |
|
| CommunitySize | integer |
None. |
|
| CommunityType | string |
None. |
|
| CommunityTypeKey | globally unique identifier |
None. |
|
| CommunityTypeName | string |
None. |
|
| CreatedByContactKey | globally unique identifier |
None. |
|
| CreatedOn | date |
None. |
|
| Description | string |
None. |
|
| Html | string |
None. |
|
| IsSubscribedToDiscussion | boolean |
None. |
|
| IsOnCommunitySync | boolean |
None. |
|
| JoinPermissionKey | globally unique identifier |
None. |
|
| LibraryKey | globally unique identifier |
None. |
|
| LibraryName | string |
None. |
|
| LinkToCommunity | string |
None. |
|
| LinkToCommunityCalendar | string |
None. |
|
| LinkToDiscussion | string |
None. |
|
| LinkToLibrary | string |
None. |
|
| LinkToWebsite | string |
None. |
|
| DiscussionKey | globally unique identifier |
None. |
|
| DiscussionName | string |
None. |
|
| MicrositeGroupKey | globally unique identifier |
None. |
|
| SiteName | string |
None. |
|
| ViewPermissionKey | globally unique identifier |
None. |
|
| Statistics | CommunityStatistics |
None. |
|
| CreatedByContact | ContactConcise |
None. |
|
| IntegrationKey |
Community Key as represented in the source data. |
string |
None. |
| IntegrationTypeKey |
Community Type Key as represented in the source data. |
string |
None. |
| ParentCommunityKey | globally unique identifier |
None. |
Response Formats
application/json, text/json
Sample:
{
"AllowMemberCreatedEvents": true,
"AllowTickets": true,
"CanMembersInviteOthers": true,
"CommunityKey": "7d4544c7-6db0-4c8f-801e-6cd33d9515fa",
"LegacyGroupKey": "sample string 5",
"CommunityName": "sample string 6",
"CommunitySize": 7,
"CommunityType": "sample string 8",
"CommunityTypeKey": "1a05b669-6cb4-448e-bcd7-87f616d936d5",
"CommunityTypeName": "sample string 10",
"CreatedByContactKey": "943e2aa5-d527-46f8-aca4-56c6e4be300c",
"CreatedOn": "2020-02-16T19:36:31.370731Z",
"Description": "sample string 13",
"Html": "sample string 14",
"IsSubscribedToDiscussion": true,
"IsOnCommunitySync": true,
"JoinPermissionKey": "ae742a3f-aeb8-4051-b0ac-b8701a8cf6ac",
"LibraryKey": "f0e8b52b-34a5-4246-9589-1cf2e2da48f1",
"LibraryName": "sample string 19",
"LinkToCommunity": "sample string 20",
"LinkToCommunityCalendar": "sample string 21",
"LinkToDiscussion": "sample string 22",
"LinkToLibrary": "sample string 23",
"LinkToWebsite": "sample string 24",
"DiscussionKey": "09871e32-db71-4dab-84f1-1d7353f7ce2d",
"DiscussionName": "sample string 26",
"MicrositeGroupKey": "1907e26d-319c-42d1-881c-8d3e4a9b0933",
"SiteName": "sample string 28",
"ViewPermissionKey": "f62f4ef4-edd4-4de6-83aa-512090411ec1",
"Statistics": {
"BlogCount": 1,
"DocumentCount": 2,
"MemberCount": 3,
"DiscussionPostCount": 4,
"CurrentYearAnnouncementCount": 5,
"CurrentYearEventCount": 6,
"LastDocumentUpdatedDate": "2020-02-16T19:36:31.370731Z",
"LastMemberJoinedDate": "2020-02-16T19:36:31.370731Z",
"LastPostingDate": "2020-02-16T19:36:31.370731Z",
"LastBlogPublishedDate": "2020-02-16T19:36:31.370731Z",
"LastAnnouncementUpdatedOnDate": "2020-02-16T19:36:31.370731Z",
"LastEventUpdatedOnDate": "2020-02-16T19:36:31.370731Z",
"MaxActivityDate": "2020-02-16T19:36:31.370731Z",
"MinActivityDate": "2020-02-16T19:36:31.370731Z"
},
"CreatedByContact": {
"LinkToProfile": "sample string 1",
"PictureUrl": "sample string 2",
"ContactKey": "f0cadbf0-134a-4916-bf94-14709fa1c134",
"FirstName": "sample string 4",
"LastName": "sample string 5",
"DisplayName": "sample string 6",
"EmailAddress": "sample string 7",
"ContactStatusCode": "sample string 8",
"PrefixCode": "sample string 9",
"UpdatedOn": "2020-02-16T19:36:31.370731Z",
"UpdatedByContactKey": "a598f221-93b9-4f6c-8e29-ad9fdb6c3c59",
"CompanyName": "sample string 12",
"CompanyTitle": "sample string 13",
"SuffixCode": "sample string 14",
"Designation": "sample string 15",
"LegacyContactKey": "sample string 16",
"InformalName": "sample string 17",
"MiddleName": "sample string 18",
"IsCompany": true,
"CompanyLegacyContactKey": "sample string 20",
"AMSDirectoryOptOut": true,
"HLDirectoryOptOut": true,
"HLContactMeOptOut": true,
"LargePictureUrl": "sample string 24",
"AgreedToTermsDateTime": "2020-02-16T19:36:31.370731Z"
},
"IntegrationKey": "sample string 30",
"IntegrationTypeKey": "sample string 31",
"ParentCommunityKey": "050ed73a-aa77-4108-b334-b11840a6ea1a"
}
application/xml, text/xml
Sample:
<Community xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
<AllowMemberCreatedEvents>true</AllowMemberCreatedEvents>
<AllowTickets>true</AllowTickets>
<CanMembersInviteOthers>true</CanMembersInviteOthers>
<CommunityKey>7d4544c7-6db0-4c8f-801e-6cd33d9515fa</CommunityKey>
<CommunityName>sample string 6</CommunityName>
<CommunitySize>7</CommunitySize>
<CommunityType>sample string 8</CommunityType>
<CommunityTypeKey>1a05b669-6cb4-448e-bcd7-87f616d936d5</CommunityTypeKey>
<CommunityTypeName>sample string 10</CommunityTypeName>
<CreatedByContact>
<AMSDirectoryOptOut>true</AMSDirectoryOptOut>
<AgreedToTermsDateTime>2020-02-16T14:36:31.370731-05:00</AgreedToTermsDateTime>
<CompanyLegacyContactKey>sample string 20</CompanyLegacyContactKey>
<CompanyName>sample string 12</CompanyName>
<CompanyTitle>sample string 13</CompanyTitle>
<ContactKey>f0cadbf0-134a-4916-bf94-14709fa1c134</ContactKey>
<ContactStatusCode>sample string 8</ContactStatusCode>
<Designation>sample string 15</Designation>
<DisplayName>sample string 6</DisplayName>
<EmailAddress>sample string 7</EmailAddress>
<FirstName>sample string 4</FirstName>
<HLContactMeOptOut>true</HLContactMeOptOut>
<HLDirectoryOptOut>true</HLDirectoryOptOut>
<InformalName>sample string 17</InformalName>
<IsCompany>true</IsCompany>
<LargePictureUrl>sample string 24</LargePictureUrl>
<LastName>sample string 5</LastName>
<LegacyContactKey>sample string 16</LegacyContactKey>
<LinkToProfile>sample string 1</LinkToProfile>
<MiddleName>sample string 18</MiddleName>
<PictureUrl>sample string 2</PictureUrl>
<PrefixCode>sample string 9</PrefixCode>
<SuffixCode>sample string 14</SuffixCode>
<UpdatedByContactKey>a598f221-93b9-4f6c-8e29-ad9fdb6c3c59</UpdatedByContactKey>
<UpdatedOn>2020-02-16T14:36:31.370731-05:00</UpdatedOn>
</CreatedByContact>
<CreatedByContactKey>943e2aa5-d527-46f8-aca4-56c6e4be300c</CreatedByContactKey>
<CreatedOn>2020-02-16T14:36:31.370731-05:00</CreatedOn>
<Description>sample string 13</Description>
<DiscussionKey>09871e32-db71-4dab-84f1-1d7353f7ce2d</DiscussionKey>
<DiscussionName>sample string 26</DiscussionName>
<Html>sample string 14</Html>
<IntegrationKey>sample string 30</IntegrationKey>
<IntegrationTypeKey>sample string 31</IntegrationTypeKey>
<IsOnCommunitySync>true</IsOnCommunitySync>
<IsSubscribedToDiscussion>true</IsSubscribedToDiscussion>
<JoinPermissionKey>ae742a3f-aeb8-4051-b0ac-b8701a8cf6ac</JoinPermissionKey>
<LegacyGroupKey>sample string 5</LegacyGroupKey>
<LibraryKey>f0e8b52b-34a5-4246-9589-1cf2e2da48f1</LibraryKey>
<LibraryName>sample string 19</LibraryName>
<LinkToCommunity>sample string 20</LinkToCommunity>
<LinkToCommunityCalendar>sample string 21</LinkToCommunityCalendar>
<LinkToDiscussion>sample string 22</LinkToDiscussion>
<LinkToLibrary>sample string 23</LinkToLibrary>
<LinkToWebsite>sample string 24</LinkToWebsite>
<MicrositeGroupKey>1907e26d-319c-42d1-881c-8d3e4a9b0933</MicrositeGroupKey>
<SiteName>sample string 28</SiteName>
<Statistics>
<BlogCount>1</BlogCount>
<CurrentYearAnnouncementCount>5</CurrentYearAnnouncementCount>
<CurrentYearEventCount>6</CurrentYearEventCount>
<DiscussionPostCount>4</DiscussionPostCount>
<DocumentCount>2</DocumentCount>
<LastAnnouncementUpdatedOnDate>2020-02-16T14:36:31.370731-05:00</LastAnnouncementUpdatedOnDate>
<LastBlogPublishedDate>2020-02-16T14:36:31.370731-05:00</LastBlogPublishedDate>
<LastDocumentUpdatedDate>2020-02-16T14:36:31.370731-05:00</LastDocumentUpdatedDate>
<LastEventUpdatedOnDate>2020-02-16T14:36:31.370731-05:00</LastEventUpdatedOnDate>
<LastMemberJoinedDate>2020-02-16T14:36:31.370731-05:00</LastMemberJoinedDate>
<LastPostingDate>2020-02-16T14:36:31.370731-05:00</LastPostingDate>
<MaxActivityDate>2020-02-16T14:36:31.370731-05:00</MaxActivityDate>
<MemberCount>3</MemberCount>
<MinActivityDate>2020-02-16T14:36:31.370731-05:00</MinActivityDate>
</Statistics>
<ViewPermissionKey>f62f4ef4-edd4-4de6-83aa-512090411ec1</ViewPermissionKey>
</Community>