Discord API · error code

Discord error 30058: Maximum number of webhooks per guild 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 webhooks per guild reached (1000)

What error 30058 means

The guild already has 1,000 webhooks across all of its channels, and creating another was refused. This is the server-wide cap; there is also a per-channel cap of 15, which returns 30007 instead. Getting 30058 means the channel you targeted may have room, but the server as a whole does not.

Very few servers need anything close to 1,000 webhooks. Reaching it almost always means a bot created webhooks and never deleted them: a relay or logging bot that creates a fresh webhook on each restart, or a per-user impersonation feature that makes a webhook per message author instead of reusing one per channel.

The endpoint is POST /channels/{channel.id}/webhooks. Deleting the leaked webhooks frees capacity immediately.

Webhooks created by feed readers, bridges and other integrations count toward the same total.

What it looks like

{
  "message": "Maximum number of webhooks per guild reached (1000)",
  "code": 30058
}

Why it happens

  • Bot creates a new webhook on every startup instead of reusing an existing one
  • Per-user or per-message webhook creation for name/avatar spoofing
  • Integrations removed without cleaning up the webhooks they created
  • Many channels each holding near the per-channel maximum

How to fix Discord error 30058

  1. 1List webhooks with GET /guilds/{guild.id}/webhooks and group by application_id or creator
  2. 2Delete webhooks created by your bot that are not in use
  3. 3Change the bot to fetch and reuse its own webhook per channel, creating one only if none exists
  4. 4Override username and avatar_url per execution instead of creating new webhooks for each identity

How to stop it recurring

Store each webhook ID and token you create, keyed by channel, and look it up before creating another. A single webhook per channel can post under any name and avatar through the execute payload. Webhook caps are on the Discord limits page.

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

Related codes

Error 30058 - quick answers

What does Discord error 30058 mean?

The guild already has 1,000 webhooks across all of its channels, and creating another was refused. This is the server-wide cap; there is also a per-channel cap of 15, which returns 30007 instead. Getting 30058 means the channel you targeted may have room, but the server as a whole does not. Very few servers need anything close to 1,000 webhooks.

How do I fix Discord error 30058?

1. List webhooks with GET /guilds/{guild.id}/webhooks and group by application_id or creator 2. Delete webhooks created by your bot that are not in use 3. Change the bot to fetch and reuse its own webhook per channel, creating one only if none exists 4. Override username and avatar_url per execution instead of creating new webhooks for each identity

Should I retry after error 30058?

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.