API Documentation

threads/create Beta

This method is currently under development and subject to change.

Creates a new thread.

URL

https://disqus.com/api/3.0/threads/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

  • forum

    Looks up a forum by ID (aka short name)

  • title

Optional

  • category

    Defaults to null

    Looks up a category by ID

  • url

    Defaults to null

    URL (defined by RFC 3986)
    Maximum length of 500

  • date

    Defaults to null

    Unix timestamp (or ISO datetime standard)

  • message

    Defaults to null

  • identifier

    Defaults to null

    Maximum length of 300

  • slug

    Defaults to null

    Alpha-numeric slug
    Maximum length of 200

Example Responses

Expand json

POST forum=bobross&title=Hello+World

{
  "code": 0,
  "response": {
    "category": "1",
    "reactions": 0,
    "identifiers": [],
    "forum": "bobross",
    "title": "Hello World",
    "dislikes": 0,
    "isDeleted": false,
    "author": "1",
    "userScore": 0,
    "id": "3",
    "isClosed": false,
    "posts": 0,
    "link": null,
    "likes": 0,
    "message": "",
    "ipAddress": "127.0.0.1",
    "slug": "hello_world",
    "createdAt": "2011-11-02T02:22:41"
  }
}