API Documentation

forums/create

Creates a new forum.

URL

https://disqus.com/api/3.0/forums/create.json

Accessibility

public key, secret key

Supported request methods

POST

Supported formats

json, jsonp

Requires authentication

yes

Rate limited

inherits global rate limit

Arguments

Required

  • name
  • short_name

Optional

  • website

    Defaults to null

    URL (defined by RFC 3986)

  • category

    Defaults to null

    Choices: Tech, Living, Style, Business, Entertainment, Celebrity, Sports, Culture, Games, News

  • adultContent

    Defaults to false

  • attach allows multiple

    Defaults to []

    Choices: followsForum, forumCanDisableAds, forumForumCategory, counters, forumDaysAlive, forumFeatures, forumIntegration, forumNewPolicy, forumPermissions

  • guidelines

    Defaults to null

  • language

    Defaults to "en"

    Translation Language

  • orgID

    Defaults to null

  • commentPolicyText

    Defaults to null

  • forumCategory

    Defaults to null

    Looks up a forum category by ID

  • commentPolicyLink

    Defaults to null

    URL (defined by RFC 3986)

  • description

    Defaults to null

    Maximum length of 300

Example Responses

Expand json

POST website=http://disqus.com&name=Bob+Ross&short_name=bobross

{
  "code":0,
  "response":{
    "id":"bobross",
    "name":"Bob Ross",
    "founder":"1",
    "favicon":{
      "permalink":"http://disqus.com/api/forums/favicons/bobross.jpg",
      "cache":"http://mediacdn.disqus.com/1091/images/favicon-default.png"
    }
  }
}