---
title: "furusato push event subscription ($0.20 paid, TTL 30d)"
method: POST
path: "/api/furusato/webhooks/subscribe"
---

# furusato push event subscription ($0.20 paid, TTL 30d)

`POST /api/furusato/webhooks/subscribe`

## Request body

- object
  - `callback_url` string, uri, required
  - `hmac_secret` string, required
  - `filter` object, required
    - `muni_code` string
    - `category` string
    - `subcategory` string
    - `gift_id` string
    - `event_types` string[]
  - `ttl_days` integer

## Response `200`

subscription_id + expires_at

## Other responses

- `402` — x402 Payment Required

---

[API](https://skmtc.net/localgov/apis/localgov-jp.md) · [All operations](https://skmtc.net/localgov/apis/localgov-jp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/localgov/localgov-jp/revisions/d5ab9236ff26/schema)