Skip to main content

Create Forum Post

Creates a new post in a Discord forum channel with support for rich content including embeds, file attachments, and buttons.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Client Id - The Discord bot client identifier from the Connect node (optional if Bot Token provided).
  • Channel Id - The ID of the Discord forum channel where the post will be created.
  • Post Title - The title for the forum post (shown in the forum channel list).
  • Message Text - The text content of the first message in the post.

Options​

  • Bot Token - Discord bot token credential (optional if using Client ID from Connect node).
  • Auto Archive Duration - Duration in minutes before the post auto-archives (0 for default, 60, 1440, 4320, 10080).
  • Files - An array of file paths to attach to the message.
  • Embed - An embed object for rich content (structured formatted messages).
  • Buttons - An array of button objects to add interactive components.

Output​

  • Post - The created forum post object containing post details, thread ID, and message information.

How It Works​

The Create Forum Post node creates a new thread post in a forum channel. When executed, the node:

  1. Authenticates using either Client ID or direct bot token
  2. Validates the channel ID, post title, and message text
  3. Constructs the post with optional components (files, embeds, buttons)
  4. Sets the auto-archive duration if specified
  5. Processes file attachments if provided
  6. Sends the create forum post request to Discord API
  7. Returns the complete post object including the thread ID

Requirements​

  • Active Discord bot session (Client ID) or bot token credentials
  • Valid forum channel ID
  • Send Messages and Create Public Threads permissions
  • The channel must be a forum channel (type 15)

Error Handling​

The node will return specific errors in the following cases:

  • ErrInvalidArg - Client ID or bot token missing/invalid
  • ErrInvalidArg - Channel ID is empty
  • ErrInvalidArg - Post title is empty
  • ErrInvalidArg - Auto archive duration is negative
  • ErrInternal - File processing errors
  • ErrInternal - Invalid embed or button structure
  • Discord API errors (missing permissions, invalid channel type, etc.)

Auto Archive Duration​

Valid values in minutes:

  • 0 - Use default server setting
  • 60 - 1 hour
  • 1440 - 24 hours (1 day)
  • 4320 - 72 hours (3 days)
  • 10080 - 168 hours (7 days)

Note: Longer durations may require server boost level.

Example: Simple Forum Post​

Inputs:

  • Channel Id: "123456789012345678"
  • Post Title: "How to use the Discord package"
  • Message Text: "Here's a guide on using Discord automation..."
  • Auto Archive Duration: 4320 (3 days)

Result: Creates a forum post that auto-archives after 3 days.

Example: Bug Report Post​

Inputs:

  • Channel Id: "123456789012345678"
  • Post Title: "Bug: Connection timeout"
  • Message Text: "Description of the bug..."
  • Embed:
{
  "title": "Bug Report",
  "color": 15158332,
  "fields": [
    {"name": "Severity", "value": "High", "inline": true},
    {"name": "Version", "value": "1.2.3", "inline": true},
    {"name": "Steps to Reproduce", "value": "1. Do this\n2. Do that"}
  ]
}

Result: Creates a structured bug report post.

Example: Announcement with Files​

Inputs:

  • Channel Id: "123456789012345678"
  • Post Title: "Monthly Update - January 2024"
  • Message Text: "Here's our monthly update with attached reports:"
  • Files: ["/reports/january-report.pdf", "/reports/chart.png"]
  • Auto Archive Duration: 10080 (7 days)

Result: Creates an announcement post with file attachments.

Example: Interactive Support Ticket​

Inputs:

  • Channel Id: "123456789012345678"
  • Post Title: "Support Ticket: {{ticket_id}}"
  • Message Text: "How can we help you?"
  • Buttons:
[
  {"Label": "Technical Issue", "Style": 1, "CustomID": "tech_issue"},
  {"Label": "Billing Question", "Style": 1, "CustomID": "billing"},
  {"Label": "General Help", "Style": 2, "CustomID": "general"}
]

Result: Creates a support ticket with category selection buttons.

Example: Automated Q&A Post​

Flow:

1. Receive Message (question from user)
2. Create Forum Post
   - Channel Id: "{{qa_forum_id}}"
   - Post Title: "Q: {{message.Content}}"
   - Message Text: "Asked by {{message.Author.Username}}"
   - Embed:
     {
       "description": "{{message.Content}}",
       "footer": {"text": "Use the thread below to answer"}
     }
3. Reply to original message with thread link

Result: Automatically create forum posts from questions.

File Attachments​

Same format as Send Channel Message:

[
  "/path/to/document.pdf",
  "/path/to/image.png"
]

Embed Objects​

Same format as Send Channel Message:

{
  "title": "Forum Post Title",
  "description": "Detailed information here",
  "color": 3447003,
  "fields": [
    {"name": "Category", "value": "General"},
    {"name": "Priority", "value": "Normal"}
  ],
  "footer": {"text": "Posted by Automation Bot"}
}

Button Components​

Same format as Send Channel Message:

[
  {
    "Label": "Mark Solved",
    "Style": 3,
    "CustomID": "mark_solved"
  },
  {
    "Label": "Need More Help",
    "Style": 1,
    "CustomID": "need_help"
  }
]

Forum Channel Requirements​

The target channel must be:

  • A forum channel (channel type 15)
  • Accessible to the bot
  • Have permissions for the bot to post

Post Object Structure​

The output contains:

{
  "ID": "thread_id_here",
  "Name": "Post Title",
  "OwnerID": "bot_id",
  "MessageCount": 1,
  "MemberCount": 1
}

Use {{post.ID}} to reference the created thread for follow-up messages.

Follow-up Messages​

To send additional messages to the created post:

1. Create Forum Post → post
2. Send Channel Message
   - Channel Id: {{post.ID}}
   - Message Text: "Additional information..."

Use Cases​

  • Support tickets - Automatically create support threads
  • Bug tracking - Create bug report posts
  • Feature requests - Log feature requests as forum posts
  • Q&A systems - Convert questions into forum posts
  • Announcements - Post updates to announcement forums
  • Documentation - Create help articles
  • Event organization - Create event discussion threads

Bot Permissions Required​

  • View Channel - See the forum channel
  • Send Messages - Post in the forum
  • Create Public Threads - Create forum posts
  • Embed Links - If using embeds
  • Attach Files - If attaching files

Forum Post Features​

Forum posts (threads) support:

  • Tags (set via Discord UI after creation)
  • Reactions on the initial message
  • Thread-specific permissions
  • Auto-archiving based on inactivity
  • Pinning within the forum

Tips and Best Practices​

  • Descriptive titles - Make post titles clear and searchable
  • Auto-archive - Set appropriate durations to keep forums organized
  • Rich content - Use embeds for structured information
  • Interactive posts - Add buttons for common actions
  • File attachments - Include relevant documents or images
  • Follow-up - Use the post ID to send additional messages
  • Tagging - Consider manual tagging for better organization
  • Permissions - Verify bot has necessary permissions
  • Testing - Test in a test forum channel first