{"uid":"cap_Wj5zked0sfWIOg7-Pp5n9","slug":"euroref-webhook-alert-registration-9318b8af","name":"euroref Webhook Alert Registration","description":"Authoritative European government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Germany (de), France (fr). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.","url":"https://euroref.dev/alerts","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["url","series"],"properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint for series.changed events"},"series":{"type":"array","items":{"type":"string"},"description":"Patterns like \"at/policy-rate\", \"be/*\", or \"*\""}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","url","series","secret"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"active":{"type":"boolean"},"secret":{"type":"string","description":"HMAC-SHA256 signing secret — shown once"},"series":{"type":"array","items":{"type":"string"}},"created":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"id":"3f6a1c2e-0000-4000-8000-000000000000","url":"https://example.com/webhook","active":true,"secret":"hex-encoded-hmac-secret","series":["de/policy-rate"],"created":"2026-07-15T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Yh19FeyiayS-p0grBKG7c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a webhook endpoint to receive notifications when European government reference data series change (e.g. policy rates, VAT rates, minimum wages, public holidays)","exampleAgentPrompt":"Set up a webhook alert on euroref so that my endpoint at https://myapp.example.com/hooks/euroref gets notified whenever the German policy rate or any French reference data series changes.","exampleUseCases":[{"title":"Central bank rate change alerting","prompt":"Register my webhook at https://treasury.mycompany.com/hooks/ecb to receive euroref alerts whenever the German or French policy rate changes — use the series pattern de/policy-rate and fr/policy-rate."},{"title":"VAT compliance monitoring for e-commerce","prompt":"I need to know the moment any VAT rate changes in Belgium or Germany — can you subscribe my endpoint https://erp.myshop.io/webhooks/vat to all euroref series matching be/* and de/*?"},{"title":"Minimum wage update subscription","prompt":"Set up a euroref webhook at https://payroll.myhr.app/alerts to watch for any minimum wage changes across all European countries — use the wildcard series pattern *."}],"resultDescription":"Returns a JSON object containing: a unique subscription ID (UUID), the registered webhook URL, an active boolean flag, a hex-encoded HMAC secret for verifying incoming webhook payloads, the list of subscribed series patterns, and the creation timestamp. The HMAC secret should be stored securely to authenticate future series.changed event deliveries.","failureModes":["Invalid or unreachable webhook URL returns a validation error","Malformed series pattern strings cause a 400 bad request","Duplicate subscription for the same URL and series may return a conflict or create a redundant subscription","Missing required fields (url or series) result in schema validation errors","Network timeout if webhook URL is unreachable at registration time","Payment failure via x402 protocol prevents subscription creation"],"whenToPreferThis":"Use this endpoint when you need real-time or near-real-time push notifications about changes to European government reference data rather than polling. Prefer this over the GET data endpoints when you want to react immediately to policy rate changes, VAT updates, or minimum wage revisions without repeatedly querying the API. Ideal for compliance systems, financial applications, or automated workflows that must stay synchronized with authoritative EU government data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:06.004Z","isFirstParty":false}