Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Security & Secrets Tier 2 All-Access

Universal Webhook Signature Verification API — Stripe, GitHub, Slack & Shopify

Verify Stripe, GitHub, Slack, Shopify, and Svix HMAC webhook signatures and timestamps. Verify HMAC webhook signatures and replay timestamps for Stripe, GitHub, Slack, Shopify, Twilio, Svix/Standard Webhooks, and custom HMAC-SHA256.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/webhook-verifyinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": false,
    "provider": "github",
    "reason": "Signature mismatch",
    "matched_scheme": null,
    "timestamp_epoch": null,
    "timestamp_age_seconds": null,
    "timestamp_valid": null
  },
  "meta": {
    "request_id": "req_wh_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/webhook-verify" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"provider":"github","secret":"whsec_test_secret_key","raw_body":"{\"action\":\"opened\"}","headers":{"x-hub-signature-256":"sha256=e90f819b28a21b5c1a40b75c0b59c8788687c76724c5870769a28240a347047f"}}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/webhook-verify", {
  "provider": "github",
  "secret": "whsec_test_secret_key",
  "raw_body": "{\"action\":\"opened\"}",
  "headers": {
    "x-hub-signature-256": "sha256=e90f819b28a21b5c1a40b75c0b59c8788687c76724c5870769a28240a347047f"
  }
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/webhook-verify",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "provider": "github",
  "secret": "whsec_test_secret_key",
  "raw_body": "{\"action\":\"opened\"}",
  "headers": {
    "x-hub-signature-256": "sha256=e90f819b28a21b5c1a40b75c0b59c8788687c76724c5870769a28240a347047f"
  }
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/webhook-verify", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "provider": "github",
  "secret": "whsec_test_secret_key",
  "raw_body": "{\"action\":\"opened\"}",
  "headers": {
    "x-hub-signature-256": "sha256=e90f819b28a21b5c1a40b75c0b59c8788687c76724c5870769a28240a347047f"
  }
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_webhook_verify",
    "arguments": {
      "provider": "github",
      "secret": "whsec_test_secret_key",
      "raw_body": "{\"action\":\"opened\"}",
      "headers": {
        "x-hub-signature-256": "sha256=e90f819b28a21b5c1a40b75c0b59c8788687c76724c5870769a28240a347047f"
      }
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/webhook-verify)

ParameterType & ConstraintsDescription
provider required "stripe" | "github" | "slack" | "shopify" | "svix" | "generic_hmac" Webhook provider signature scheme to verify.
raw_body required string
maxLen: 262144
Exact raw HTTP request body string (must not be re-serialized).
headers required object Incoming HTTP headers map (case-insensitive keys).
secret optional string
minLen: 1, maxLen: 1024
Webhook signing secret (or omit from body and pass via X-Tinplate-Signing-Secret header; processed strictly in memory, never logged).
tolerance_seconds optional integer
min: 0, max: 86400
Maximum allowed timestamp age in seconds for timestamped schemes (default 300; 0 disables).
now_epoch_seconds optional integer
min: 0
Optional reference Unix timestamp in seconds (defaults to current time).
generic_options optional object Options when provider is 'generic_hmac'.

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
provider "stripe" | "github" | "slack" | "shopify" | "svix" | "generic_hmac" Webhook provider signature scheme to verify.
reason string | null Field 'reason'
matched_scheme string | null Field 'matched_scheme'
timestamp_epoch integer | null Field 'timestamp_epoch'
timestamp_age_seconds integer | null Field 'timestamp_age_seconds'
timestamp_valid boolean | null Field 'timestamp_valid'

What Webhook Signature Verifier API Detects & Validates

  • Built-in provider profiles: Stripe (v1= + t= timestamp), GitHub (sha256=), Slack (v0:timestamp:body), Shopify (Base64 HMAC), Svix / Standard Webhooks
  • Custom HMAC-SHA256 / SHA512 hex or base64 verification
  • Constant-time digest comparison via WebCrypto to prevent timing attacks
  • Replay-window tolerance enforcement on timestamped webhooks (Stripe, Slack, Svix)
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Supports symmetric HMAC providers; asymmetric Ed25519/RSA webhook providers (e.g. Discord interactions) are not included in v1.
  • Caller must pass the exact unparsed raw_body string received over the wire.

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Why does webhook verification fail if I pass JSON.stringify(req.body)?

HMAC signatures are computed over the exact raw byte string sent by the provider. Always pass the unparsed raw request body.

Does it check for replay attacks on Stripe and Slack webhooks?

Yes, it validates that the signed timestamp is within the configurable tolerance_seconds window (default 300s).

Is my webhook secret logged?

Never. Secrets are used solely for the in-memory WebCrypto HMAC calculation and discarded immediately.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Webhook signing secrets and raw bodies are verified in volatile V8 memory and never logged or stored.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/consent-tokens/issue Email & Domain

Stateless Consent & One-Click Unsubscribe Tokens API

Issue and verify stateless HMAC unsubscribe tokens and RFC 8058 List-Unsubscribe headers.

POST /v1/agent-action-receipts/issue AI Safety & Agents

Agent Action Receipts API

Issue and verify tamper-evident HMAC-signed receipts for autonomous AI agent actions.

POST /v1/secret-scanner Tier 1

Log Redact & Secret Scanner API

Detect and mask leaked API keys, JWTs, and private keys in logs, diffs, and prompts.