discord-webhook

What it is and what it does

discord-webhook is a Python wrapper around Discord's webhook API that lets you send messages to Discord channels without creating a bot. It handles the HTTP requests to Discord via the requests library and provides a simple object-oriented interface for constructing and sending webhook payloads.

The package supports basic text messages, rich embeds with custom fields and formatting, file attachments, thread targeting, and automatic rate-limit retry logic. It also includes async variants of its main methods for non-blocking use in async applications. You provide a webhook URL (obtained from Discord server settings), instantiate a DiscordWebhook object with your message content, and call execute() to send it; the package manages serialization, HTTP transport, and response handling.

Use it for:

• Send automated alerts or notifications from a monitoring system to a Discord channel without running a persistent bot.
• Post build or deployment status updates from CI/CD pipelines directly to Discord.
• Create rich formatted messages with embeds, images, and structured fields for logging or reporting.
• Distribute files (images, logs, reports) to Discord channels programmatically.
• Send messages to specific Discord threads or create new threads in forum channels via webhook.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Send messages to Discord channels via webhooks, with support for embeds, files, threads, rate-limit handling, and async operations.

Yes. The package is stable, has no known vulnerabilities, low install friction, and a permissive license. Maintenance is aging (no release since March 2025, last commit August 2025), but the repository is active and the core functionality is mature. Install if you need a straightforward way to send Discord webhooks; be aware that updates may be infrequent.

Install

discord-webhook on PyPI

pip install discord-webhook

uv add discord-webhook

poetry add discord-webhook

Installing discord-webhook

Before you install

Low install friction; single runtime dependency (requests). Maintenance status is aging—last commit was 2025-08-06 and the package has not had a release since 2025-03-05, though the repository remains active and not archived.

License in practice

MIT license (permissive); you may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

from discord_webhook import DiscordWebhook

webhook = DiscordWebhook(url="your webhook url", content="Webhook Message")
response = webhook.execute()

You must obtain a Discord webhook URL from your server settings before use.

Verify before relying

• Whether async support is fully documented and production-ready in the current version.
• Current rate-limit retry behavior and whether it handles all Discord rate-limit scenarios.

Package facts

Evidence: discord_webhook-1.4.1-py3-none-any.whl

Keywords: discord, webhook

Tags

More Internet packages