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

Expandjson

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"}}
close