Create a Thread

This action cannot be used for forum channels! For forum thread creation, use discord API here.

The Create a Thread block enables you to create threads within your server through commands or events.

Each created thread has a unique variable that you can use to reference the thread in your command and can be identified by just looking for {created_thread_xyz}.

Channel

To create the thread, you need to specify what channel you are going to create the thread in. There is three provided options to achieve this.

This selection will create the thread in the channel that the command / event was executed in or where a button / menu option was clicked.

Start Message ID

This an optional field allows you to create the thread from a specific message. The only input for this field is a plain message ID with no extra symbols or spaces. A variable can be used as well.

Name

This is a required option, and it is the name of the thread that you want to create. You can use variables or options as well.

Type

This is an optional option (public is default), and it is the type of thread that you want to create. You can choose from 3 types of thread types.

TypeInformation

Public Thread

This type of thread is public which means it can be viewed by everyone in the server or everyone who has access to the channel it is in.

Private Thread

This is the opposite of the Public Thread type which means it can't be viewed by everyone.

Announcement Thread

This thread works similar to an announcement channel, any message in this thread can be published.

Auto Archive

This is an optional field, and it is the time in which the thread will auto-archive itself. You can choose from 4 options:

  • One Hour

  • One Day

  • Three Days

  • One Week

Reason

This is an optional field. In this field you can input a reason why you are creating a thread. This reason will be shown in your server's audit log. Variables can also be used in this field.

Slowmode

This is an optional field, also known as rate limit per user, it allows you to set a slowmode in the thread for each user unless the user has been bypassed. This field only accepts integers, and variables can be used.

Moderators Invite

This option is only valid if the thread type is a Private Thread. This field is optional and it allows you to toggle whether a non-moderator can invite other users to the thread.

Variables

You can now access various variables from the created thread and use them throughout your custom command (as long as it is in the same interaction). You can use these variables by just adding them to the end of the {created_thread_abcd} variable, but before the }. The 4 characters "abcd" are shown in your create thread block at the top.

An example to get the name would be like this: {created_thread_48f3.name}.

NameDescription

.name

Returns the name of the thread

.id

Returns the ID of the thread

.parent

Returns the parent channel of the thread

.parent_id

Returns the parent's ID of the thread

.archived

Returns whether the thread is archived or not (as true or false)

.locked

Returns whether the thread is locked or not (as true or false)

.invitable

Returns whether a non-moderator can invite users to the thread or not (as true or false)

.owner_id

Returns the thread owner's ID

.url

Returns the url of the thread

Last updated