Skip to main content

Python library for Standard Webhooks

Example

Verifying a webhook payload:

from standardwebhooks.webhooks import Webhook

wh = Webhook(base64_secret)
wh.verify(webhook_payload, webhook_headers)

webhook_payload must be the raw request body exactly as received, before any JSON parsing. Pass it as bytes to verify the bytes as sent, including bodies that aren't valid UTF-8. A str is verified as its UTF-8 encoding.

Responding to endpoint verification:

challenge = webhook_headers.get("webhook-challenge")
if challenge:
    response_headers["webhook-challenge-response"] = wh.endpoint_verification_response(challenge)
    # Not a webhook delivery: respond (e.g. with 204 No Content) without processing the body
    return

Verifying the response as a producer (raises WebhookVerificationError if it doesn't match):

wh.verify_endpoint_verification_response(challenge, response_headers["webhook-challenge-response"])

Development

Requirements

  • python 3

Installing dependencies

python -m venv .venv
pip install -r requirements.txt && pip install -r requirements-dev.txt

Contributing

Before opening a PR be sure to format your code!

./scripts/format.sh

Running Tests

Simply run:

pytest

Metadata

Release files for standardwebhooks 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for standardwebhooks 1.3.0
File Size Uploaded Provenance Actions
standardwebhooks-1.3.0.tar.gz 5.0 kB With provenance Details for standardwebhooks-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for standardwebhooks 1.3.0
File Interpreter ABI Platform Actions
standardwebhooks-1.3.0-py3-none-any.whl Python 3 none any Details for standardwebhooks-1.3.0-py3-none-any.whl

Total release size: 10.5 kB

Release files / standardwebhooks-1.3.0.tar.gz

Download URL standardwebhooks-1.3.0.tar.gz
Size 5.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ee071d454f1d349802678d4990fdebd6c2d629be11be294f561343b6db200608
BLAKE2b-256 checksum
How to use checksums
6d41c53141ee70970c3e553e90b4aaa65cdcbdd72fabbab91ff3b0a63f902526
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / standardwebhooks-1.3.0-py3-none-any.whl

Download URL standardwebhooks-1.3.0-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5bec388e29d3e8c6211af66affa1430ac801cb02f3b132484ef4b8f89d32a5ad
BLAKE2b-256 checksum
How to use checksums
bfe44e66444745a07b6cfeb0c3b058fe1d042b5928c8b8c0f3047d3610895aed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for standardwebhooks 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for standardwebhooks-1.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page