# euroref Webhook Alert Registration

> euroref Webhook Alert Registration is a paid API for AI agents from euroref.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Registers a webhook endpoint to receive notifications when European government reference data series change (e.g. policy rates, VAT rates, minimum wages, public holidays)

## Facts

- Endpoint: POST https://euroref.dev/alerts
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/euroref-webhook-alert-registration-9318b8af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wj5zked0sfWIOg7-Pp5n9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability euroref-webhook-alert-registration-9318b8af -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-webhook-alert-registration-9318b8af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from euroref.dev](https://www.zero.xyz/host/euroref.dev/llms.txt)