{"uid":"cap_L6ee8t9-OrH3inrcoGIzp","slug":"afriref-webhook-alert-subscription-f698c0b8","name":"afriref Webhook Alert Subscription","description":"Authoritative Pan-African government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Côte d'Ivoire (ci), Egypt (eg), Ethiopia (et), Ghana (gh), Kenya (ke), Morocco (ma), Nigeria (ng), Rwanda (rw), Senegal (sn), Tanzania (tz), Uganda (ug). 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://afriref.dev/alerts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint for series.changed events"},"series":{"type":"array","items":{"type":"string"},"description":"Patterns like \"ao/policy-rate\", \"bf/*\", or \"*\""}}},"responseSchema":{"type":"json","example":{"id":"3f6a1c2e-0000-4000-8000-000000000000","url":"https://example.com/webhook","active":true,"secret":"hex-encoded-hmac-secret","series":["ci/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_HEdsZiPCHEKsGvAh077i3","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 real-time notifications when Pan-African government reference data series (policy rates, VAT, wages, holidays) change","exampleAgentPrompt":"Set up a webhook to my endpoint at https://example.com/webhook so I get notified whenever Nigeria's policy rate or Ghana's VAT rate changes — I need the HMAC secret to verify the payloads.","exampleUseCases":[{"title":"Monitor central bank rate changes","prompt":"Register my server at https://hooks.myapp.io/afriref to receive alerts whenever any African central bank policy rate changes — subscribe me to the pattern *\\/policy-rate across all countries."},{"title":"Track Kenya and Nigeria compliance data","prompt":"Set up a webhook to https://compliance.myfintech.com/updates for changes to Kenya and Nigeria's VAT rates and minimum wages — use the series patterns ke/* and ng/*."},{"title":"Automate regulatory dashboard refresh","prompt":"I want my dashboard at https://dashboard.acme.org/refresh to get pinged automatically whenever Côte d'Ivoire or Morocco updates any of their government reference data — subscribe to ci/* and ma/*."}],"resultDescription":"Returns a subscription object containing a unique subscription ID (UUID), the registered webhook URL, an active boolean flag, a hex-encoded HMAC secret for payload verification, the list of subscribed series patterns, and the creation timestamp. The HMAC secret is used to authenticate incoming webhook POST payloads from afriref when series data changes.","failureModes":["Invalid webhook URL format returns a 400 validation error","Unreachable webhook URL may cause silent failures on event delivery","Invalid series pattern syntax returns an error","Payment failure via x402 prevents subscription creation","Duplicate subscriptions for the same URL and series may be created if not deduplicated client-side"],"whenToPreferThis":"Choose this endpoint when you need real-time push notifications of African government reference data changes rather than polling. Ideal for compliance dashboards, fintech applications pricing Africa-specific products, or regulatory monitoring systems that need to react immediately when central bank rates, VAT, wages, or holidays are updated. Prefer this over periodic GET polling when low latency on data changes matters or when you want to avoid unnecessary API call costs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:44:03.224Z","isFirstParty":false}