Discord API · error code

Discord error 30038: Maximum number of uncompleted guild scheduled events reached (100)

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

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
Maximum number of uncompleted guild scheduled events reached (100)

What error 30038 means

A guild can have at most 100 scheduled events that are not yet completed, and creating another one was refused. Events that are still scheduled or currently active both count toward this total.

Bots that mirror an external calendar into Discord events are the usual source: they create an event for every entry weeks or months ahead and never prune entries that were cancelled upstream. Recurring-event bots that create a separate Discord event for each occurrence reach it in the same way.

The endpoint is POST /guilds/{guild.id}/scheduled-events. Nothing is wrong with the payload or the bot's permissions; the guild has simply reached its cap on open events.

The count is per guild, not per creator, so events made by people in the client and by other bots share the same pool as yours.

What it looks like

{
  "message": "Maximum number of uncompleted guild scheduled events reached (100)",
  "code": 30038
}

Why it happens

  • Calendar sync bot creating events far into the future
  • Cancelled upstream events never deleted from Discord
  • Separate Discord event created for each occurrence of a recurring series
  • Past events left in an active or scheduled state instead of being ended

How to fix Discord error 30038

  1. 1List events with GET /guilds/{guild.id}/scheduled-events and count unfinished ones
  2. 2Delete events that were cancelled in the source calendar
  3. 3End active events by setting status 3 (COMPLETED) and cancel scheduled ones that will not happen with status 4 (CANCELED), so they stop counting
  4. 4Limit the sync window, for example only the next few weeks, then retry

How to stop it recurring

Sync a rolling window rather than the whole calendar, and reconcile deletions as well as additions on every run. Ending events promptly when they finish keeps the open count honest. Lookups against events removed in the meantime return 10070.

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

Related codes

Error 30038 - quick answers

What does Discord error 30038 mean?

A guild can have at most 100 scheduled events that are not yet completed, and creating another one was refused. Events that are still scheduled or currently active both count toward this total. Bots that mirror an external calendar into Discord events are the usual source: they create an event for every entry weeks or months ahead and never prune entries that were cancelled upstream.

How do I fix Discord error 30038?

1. List events with GET /guilds/{guild.id}/scheduled-events and count unfinished ones 2. Delete events that were cancelled in the source calendar 3. End active events by setting status 3 (COMPLETED) and cancel scheduled ones that will not happen with status 4 (CANCELED), so they stop counting 4. Limit the sync window, for example only the next few weeks, then retry

Should I retry after error 30038?

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.