Discord API · error code

Discord error 30033: Maximum number of thread participants has been reached (1000)

Permanent - do not retryHTTP 400Maximum reached (30xxx)

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
Maximum number of thread participants has been reached (1000)

What error 30033 means

A thread can have at most 1,000 members, and your request would add one more. The usual call is PUT /channels/{channel.id}/thread-members/{user.id}, which a bot uses to pull a user into a thread, or PUT /channels/{channel.id}/thread-members/@me when the bot joins itself.

Thread membership in Discord is what makes a thread show in someone's sidebar and receive notifications. Bots that add every member of a role to a thread for visibility hit this cap quickly in large servers, as do event and announcement threads that auto-add attendees.

Users can still read a public thread without being members of it. Being full only stops new members from being added, not from viewing.

Each add or removal is also delivered to clients as thread member updates, so bulk-adding members creates a burst of gateway traffic as well as REST calls.

What it looks like

{
  "message": "Maximum number of thread participants has been reached (1000)",
  "code": 30033
}

Why it happens

  • Bot adds every member of a large role to one thread
  • Event or giveaway thread auto-adds each participant
  • Long-lived support thread accumulated members over time

How to fix Discord error 30033

  1. 1Check the thread's member_count before adding more members
  2. 2Mention the role in the thread instead of adding each member individually
  3. 3Create a new thread for overflow, or remove inactive members with DELETE /channels/{channel.id}/thread-members/{user.id}
  4. 4Retry the add only after the count drops below 1,000
  5. 5Add members in small batches that respect the rate-limit headers, rather than in a tight loop

How to stop it recurring

Use threads for focused conversations and channels for large audiences. If a feature needs to notify hundreds of people, a role mention or a channel post scales better than adding each person to a thread. Related caps on active threads are covered on 160006.

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

Related codes

Error 30033 - quick answers

What does Discord error 30033 mean?

A thread can have at most 1,000 members, and your request would add one more. The usual call is PUT /channels/{channel.id}/thread-members/{user.id} , which a bot uses to pull a user into a thread, or PUT /channels/{channel.id}/thread-members/@me when the bot joins itself. Thread membership in Discord is what makes a thread show in someone's sidebar and receive notifications.

How do I fix Discord error 30033?

1. Check the thread's member_count before adding more members 2. Mention the role in the thread instead of adding each member individually 3. Create a new thread for overflow, or remove inactive members with DELETE /channels/{channel.id}/thread-members/{user.id} 4. Retry the add only after the count drops below 1,000 5. Add members in small batches that respect the rate-limit headers, rather than in a tight loop

Should I retry after error 30033?

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.