Discord error 30019: Maximum number of server members reached
Last verified against Discord Developer Docs - Opcodes and status codes
Maximum number of server members reachedWhat error 30019 means
The guild is at its member cap, so Discord refused to add another member. For bots this comes up on PUT /guilds/{guild.id}/members/{user.id}, the Add Guild Member endpoint used by OAuth2 guilds.join flows, where a website or verification bot adds users to a server on their behalf.
The cap is set by Discord for each server and is not something your bot can raise. The literal message does not state a number, so do not hard-code one in your error text. The same limit stops ordinary invites from working, which means users clicking an invite link see a failure as well.
This is different from 30001, which is about the user being in too many servers, not the server having too many users.
What it looks like
{
"message": "Maximum number of server members reached",
"code": 30019
}Why it happens
- Server reached its member cap and a guilds.join flow tried to add one more user
- Large community growth outpaced cleanup of inactive members
- Verification or onboarding service adding users in bulk
How to fix Discord error 30019
- 1Confirm the server's member count via GET /guilds/{guild.id}?with_counts=true
- 2Show the user a clear message that the server is full instead of a generic error
- 3Ask the server owner to prune inactive members or contact Discord about the cap
- 4Retry the join only after the member count drops
How to stop it recurring
Read approximate_member_count during onboarding and pause automated joins as the server approaches the cap. Distinguish 30019 from 30001 in your error handling, since one is fixed by the server owner and the other by the user leaving servers. Log the guild ID with each failure so repeated errors point to the right server.
Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.
Related codes
- 30001: Maximum number of guilds reached (100)Maximum number of guilds reached (100)
- 40007: User is banned from this guildThe user is banned from this guild
- 50026: Missing required OAuth2 scopeMissing required OAuth2 scope
- 40002: Account verification requiredYou need to verify your account in order to perform this action
Error 30019 - quick answers
What does Discord error 30019 mean?
The guild is at its member cap, so Discord refused to add another member. For bots this comes up on PUT /guilds/{guild.id}/members/{user.id} , the Add Guild Member endpoint used by OAuth2 guilds.join flows, where a website or verification bot adds users to a server on their behalf. The cap is set by Discord for each server and is not something your bot can raise.
How do I fix Discord error 30019?
1. Confirm the server's member count via GET /guilds/{guild.id}?with_counts=true 2. Show the user a clear message that the server is full instead of a generic error 3. Ask the server owner to prune inactive members or contact Discord about the cap 4. Retry the join only after the member count drops
Should I retry after error 30019?
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.