Discord API · error code

Discord error 40067: A tag is required to create a forum post

Permanent - do not retryHTTP 400Validation and request shape

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
A tag is required to create a forum post in this channel

What error 40067 means

The forum has the REQUIRE_TAG flag (1 << 4) set, and you created a post without any tags. Every new thread in such a forum must include at least one tag ID in applied_tags.

This affects POST /channels/{channel.id}/threads for bots and the webhook equivalent when a webhook creates a post with thread_name. Bots that worked yesterday start failing when an admin turns on the "require tags" setting, because nothing in the bot's payload changed.

The tag IDs come from the forum channel's available_tags array. Names are not accepted; you must send the snowflake IDs. If no tag is available to the bot because they are all moderator-only, the error is 40066.

A post can carry at most 5 tags, so automated posters that add several tags should cap the list.

What it looks like

{
  "message": "A tag is required to create a forum post in this channel",
  "code": 40067
}

Why it happens

  • Forum requires tags and the request omitted applied_tags
  • applied_tags sent as tag names instead of IDs
  • Admin enabled the require-tag setting after the bot was configured
  • Webhook forum post created without applied_tags

How to fix Discord error 40067

  1. 1Fetch the forum channel and read its flags and available_tags
  2. 2Add at least one tag ID to applied_tags in the thread create body
  3. 3Store a configurable default tag per forum for automated posts
  4. 4Retry and confirm the post appears with the tag applied
  5. 5Keep applied_tags to 5 IDs or fewer

How to stop it recurring

Always send applied_tags when posting to forums, even when not required, by keeping a default tag in your bot's per-forum config. Re-read the forum flags when CHANNEL_UPDATE arrives so a newly required tag does not break automated posts. Forum posting basics are on 40058.

Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.

Related codes

Error 40067 - quick answers

What does Discord error 40067 mean?

The forum has the REQUIRE_TAG flag ( 1 << 4 ) set, and you created a post without any tags. Every new thread in such a forum must include at least one tag ID in applied_tags . This affects POST /channels/{channel.id}/threads for bots and the webhook equivalent when a webhook creates a post with thread_name .

How do I fix Discord error 40067?

1. Fetch the forum channel and read its flags and available_tags 2. Add at least one tag ID to applied_tags in the thread create body 3. Store a configurable default tag per forum for automated posts 4. Retry and confirm the post appears with the tag applied 5. Keep applied_tags to 5 IDs or fewer

Should I retry after error 40067?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging Discord by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.