Creates a new topic in a group.

This method requires the following permissions: groups.

Parameters

group_id
integer

Identifier of the group where to create the topic.

title
string

The title of the topic.

message
string

The text of the first comment in the topic. Required if there are no attachments. This parameter supports formatted text, the format is determined by the text_format parameter.

text_format
enum

The format of the comment text passed in message. By default, the user’s preference is used.

Possible values: markdown, html, plain.

attachments
array of objects

JSON array representing the media attachments to be added to the first comment. See the separate page for the object description. Required if there is no message.

content_warning
string

If this is not empty, make the content of the comment hidden by default, requiring a click to reveal. This text will be shown instead of the content.

guid
string

A unique identifier used to prevent accidental double-posting on unreliable connections. If board.createTopic was previously called with this guid in the last hour, no new topic will be created, the ID of that previously created topic will be returned instead. Recommended for mobile apps.

Result

The identifier of the newly created topic.

Errors

Global errors may occur when calling this method.