# ausref Alerts Webhook Registration

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

Registers a webhook endpoint to receive real-time notifications when Australasian government reference data series change (e.g. RBA policy rate, GST, minimum wage, public holidays).

## Facts

- Endpoint: POST https://ausref.dev/alerts
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ausref-alerts-webhook-registration-a88cf783
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZVwfG8sSsjMN9_PGbeWo4

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 ausref-alerts-webhook-registration-a88cf783 -d '<json body>'
```

Example prompt: Set up a webhook alert to https://hooks.myapp.com/ausref-events so I get notified whenever the Australian central bank policy rate or New Zealand GST rate changes — subscribe to au/policy-rate and nz/vat-rate series.

## When to prefer this

Use this endpoint when you need push-based, real-time notifications of Australasian government data changes rather than polling. Prefer this over polling the data endpoints directly when you need low-latency reaction to rate/policy changes (e.g. repricing engines, payroll triggers, compliance monitors). It is the right choice when your system has a publicly reachable webhook URL and you want to subscribe to specific series or wildcard patterns.

## Known failure modes

- Invalid or unreachable webhook URL returns 4xx validation error
- Malformed series pattern (e.g. unsupported region code) returns error
- Duplicate subscription for same URL and series may return conflict
- Payment failure (x402) prevents subscription creation
- Network timeout during registration leaves subscription state unknown

## How this service works

Authoritative Australasian government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Australia (au), New Zealand (nz). 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 the new subscription's UUID, the registered webhook URL, an active boolean flag, an HMAC secret for verifying incoming webhook payloads, the list of subscribed series patterns, and the creation timestamp.

## 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 \"au/policy-rate\", \"fj/*\", 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": [
   "au/policy-rate"
  ],
  "created": "2026-07-15T12:00:00.000Z"
 }
}
```

## More

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