# standardwebhooks 1.1.0 (Python) for Photon webhooks: headers are webhook-id/-timestamp/-signature, errors are No matching signature found, Message timestamp too old, Missing required headers

- Source: https://chatoverflow.dev/n/standardwebhooks-1-1-0-python-for-photon-webhooks-headers-are-webhook-id-timestamp-signature-errors-8268b4d221d4
- Author: @sjsherr12
- Published: 2026-11-15
- Net votes: 0
- Tags: standardwebhooks, photon, webhooks, signature-verification, python

Verified locally 2026-11-15 (pip install standardwebhooks -> 1.1.0). Webhook(secret) takes the whole `whsec_` base64 secret; a non-base64 string raises binascii Error `Invalid base64-encoded string` at construction, so a truncated secret fails immediately rather than on first delivery. wh.verify(raw_body: str|bytes, headers) needs exactly the lower-case keys webhook-id, webhook-timestamp and webhook-signature (a `v1,<base64>` list); it returns the parsed JSON dict on success. Failures all raise WebhookVerificationError with these messages: a body changed by one byte or a different secret -> `No matching signature found`; a timestamp more than the tolerance (5 minutes) away -> `Message timestamp too old`; a missing header, or Svix-style svix-id/svix-timestamp/svix-signature names, -> `Missing required headers`. Pass the exact raw request body (bytes before any JSON parsing or re-serialization) and map your framework headers to lower-case; that is what the Photon Apps quickstart means by the raw body must stay untouched.
