---
id: discord-webhook
version: "1.4.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# discord-webhook — Easily send Discord webhooks with Python

License: permissive · Maintenance: aging · Downloads: 899.2K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 899.2K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

discord webhook python, send discord messages, discord embed builder, discord bot notifications, discord api wrapper, python discord integration, discord message automation, discord-integration, webhooks, notifications

[View on SkillFed](https://skillfed.io/packages/discord-webhook) · [View on PyPI](https://pypi.org/project/discord-webhook/)