---
title: "Register a webhook for stake state change notifications"
method: POST
path: "/api/v1/webhooks"
tags: ["Webhooks"]
---

# Register a webhook for stake state change notifications

`POST /api/v1/webhooks`

## Request

- Base URL: `https://solentic.theblueprint.xyz`
- URL: `https://solentic.theblueprint.xyz/api/v1/webhooks`
- Auth: none required

Register a callback URL to receive POST notifications when stake state changes. Events: withdraw_ready, epoch_complete, stake_activated, stake_deactivated. Solentic polls every 60 seconds and POSTs to your URL when events fire. HTTPS only.

## Request body

- object
  - `callbackUrl` string, uri, required: HTTPS URL to receive webhook POST requests
  - `walletAddress` string, required: Wallet address to monitor
  - `events` string[], required: Event types to subscribe to

## Response `200`

Webhook registered

- object
  - `id` string
  - `callbackUrl` string
  - `walletAddress` string
  - `events` string[]
  - `createdAt` string
  - `message` string
  - `_meta` Meta (unresolved $ref)

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/theblueprint/apis/blueprint-staking-api.md) · [All operations](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/revisions/326d6015b851?raw)