Stateless Consent & One-Click Unsubscribe Tokens API
Issue and verify stateless HMAC unsubscribe tokens and RFC 8058 List-Unsubscribe headers.
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.
{
"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
}
}
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"
}
}
}
}POST /v1/webhook-verify)| Parameter | Type & Constraints | Description |
|---|---|---|
provider required |
"stripe" | "github" | "slack" | "shopify" | "svix" | "generic_hmac" |
Webhook provider signature scheme to verify. |
raw_body required |
stringmaxLen: 262144 |
Exact raw HTTP request body string (must not be re-serialized). |
headers required |
object |
Incoming HTTP headers map (case-insensitive keys). |
secret optional |
stringminLen: 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 |
integermin: 0, max: 86400 |
Maximum allowed timestamp age in seconds for timestamped schemes (default 300; 0 disables). |
now_epoch_seconds optional |
integermin: 0 |
Optional reference Unix timestamp in seconds (defaults to current time). |
generic_options optional |
object |
Options when provider is 'generic_hmac'. |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
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' |
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 →
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).
| Plan | Monthly Price | Included Requests | Rate Limit | Max Payload | Best For |
|---|---|---|---|---|---|
| BASIC | $0.00 / mo | 500 / month | 10 req / min | 64 KB | Evaluation & CI smoke tests |
| PRO | $9.99 / mo | 15,000 / month | 60 req / min | 128 KB | Solo devs & production apps |
| ULTRA | $29.99 / mo | 100,000 / month | 300 req / min | 256 KB | Growing SaaS & multi-agent pipelines |
| MEGA | $79.99 / mo | 500,000 / month | 1,000 req / min | 256 KB | High-volume enterprise workloads |
HMAC signatures are computed over the exact raw byte string sent by the provider. Always pass the unparsed raw request body.
Yes, it validates that the signed timestamp is within the configurable tolerance_seconds window (default 300s).
Never. Secrets are used solely for the in-memory WebCrypto HMAC calculation and discarded immediately.
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.
Issue and verify stateless HMAC unsubscribe tokens and RFC 8058 List-Unsubscribe headers.
Issue and verify tamper-evident HMAC-signed receipts for autonomous AI agent actions.
Detect and mask leaked API keys, JWTs, and private keys in logs, diffs, and prompts.