{"_id":"570f9681b85a841900aa9534","version":{"_id":"56abbf55f25f160d00e17f51","project":"56abbf55f25f160d00e17f4e","__v":12,"createdAt":"2016-01-29T19:36:53.665Z","releaseDate":"2016-01-29T19:36:53.665Z","categories":["56abbf56f25f160d00e17f52","56abca6bf9757e0d007c6650","56acddfa0ab3c00d00ce3332","56af65da9d32e30d0006d30f","56af66cab34d210d003d9ad0","56af6afcd21e9c0d00b628d1","56af6d6ecc4cbd0d00ce2c88","5705b12221cfed0e00e8c580","570a5676ade45d0e00c1ad33","570d7d25d1e4b82000d9e385","570eac3c3160d10e0041df0e","575709000fd6a3200010dded"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"56af6d6ecc4cbd0d00ce2c88","pages":["56af6e8460a37a0d00ed87ac","56af71e58be2ea0d00b48887","56af73a08be2ea0d00b48890"],"version":"56abbf55f25f160d00e17f51","__v":3,"project":"56abbf55f25f160d00e17f4e","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-01T14:36:30.275Z","from_sync":false,"order":2,"slug":"concepts","title":"Kongregate APIs & Concepts"},"parentDoc":null,"user":"56abbec30b9e0b0d00616274","project":"56abbf55f25f160d00e17f4e","__v":2,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-14T13:09:21.283Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Note\",\n  \"body\": \"This feature will not function unless we have enabled it for your game. If you would like to have this feature enabled, please email us at [apps:::at:::kongregate.com](mailto:apps@kongregate.com)\"\n}\n[/block]\n### Guilds\n\nHaving guilds in your game is a great way for players to interact with each other and build a sense of community. All of Kongregate's top performing games use guilds as a way to increase player engagement by adding guild-specific events and giving players meaningful advantages for contributing to the well being of their guild.\n\n### Overview\n\nThe guilds API allows games with guilds to give additional features to their users. These additional features include private forums and their own guild chat while users are playing on Kongregate.\n\n### Guild Chat\n\n![](http://cdn1.kongcdn.com/assets/files/0001/1072/guild_chat.png)\n\nGuild chat is a great way for members to talk to each other while playing your game on the site. Guild chat will automatically launch for a user who is in a guild in your game, and will also be accessible when a user plays other games on Kongregate as well, so users can still chat with their guildmates even when not playing the game their guild is for.\n\n### Guild Forums\n\nGuild members can use their guild-specific forums to coordinate events and have longer debates and conversations. Users that are denoted as Admins by the Guilds API are able to lock, sticky, edit, and hide forum posts in the guild forum.\n\n![](http://cdn1.kongcdn.com/assets/files/0001/1074/guild_forums.png)\n\n* * *\n\n### Using the Guilds API\n\nIn dealing with guilds, there are two elements. The Guilds themselves, and the Characters, who are the players that populate the guilds. Both can be managed using the [Server Side API](doc:server-side-http) using the following endpoints:\n\n* [Create a guild](doc:server-api-create-guild)\n* [Destroy a guild](doc:server-api-destroy-guild)\n* [Manage characters](doc:server-api-characters)","excerpt":"Add guild forums and chat to your game","slug":"api-guilds","type":"basic","title":"Guilds"}

Guilds

Add guild forums and chat to your game

[block:callout] { "type": "warning", "title": "Note", "body": "This feature will not function unless we have enabled it for your game. If you would like to have this feature enabled, please email us at [apps@kongregate.com](mailto:apps@kongregate.com)" } [/block] ### Guilds Having guilds in your game is a great way for players to interact with each other and build a sense of community. All of Kongregate's top performing games use guilds as a way to increase player engagement by adding guild-specific events and giving players meaningful advantages for contributing to the well being of their guild. ### Overview The guilds API allows games with guilds to give additional features to their users. These additional features include private forums and their own guild chat while users are playing on Kongregate. ### Guild Chat ![](http://cdn1.kongcdn.com/assets/files/0001/1072/guild_chat.png) Guild chat is a great way for members to talk to each other while playing your game on the site. Guild chat will automatically launch for a user who is in a guild in your game, and will also be accessible when a user plays other games on Kongregate as well, so users can still chat with their guildmates even when not playing the game their guild is for. ### Guild Forums Guild members can use their guild-specific forums to coordinate events and have longer debates and conversations. Users that are denoted as Admins by the Guilds API are able to lock, sticky, edit, and hide forum posts in the guild forum. ![](http://cdn1.kongcdn.com/assets/files/0001/1074/guild_forums.png) * * * ### Using the Guilds API In dealing with guilds, there are two elements. The Guilds themselves, and the Characters, who are the players that populate the guilds. Both can be managed using the [Server Side API](doc:server-side-http) using the following endpoints: * [Create a guild](doc:server-api-create-guild) * [Destroy a guild](doc:server-api-destroy-guild) * [Manage characters](doc:server-api-characters)