Webhooks
Webhook management for wallet/network. Caller must have access to the wallet's node.
Authentication: Bearer token required.
List Webhooks
Endpoint: GET /api/v1/webhooks
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| wallet_id | string | No | — | Filter by wallet UUID |
| page | int | No | 1 | Page number |
| per_page | int | No | 10 | Items per page (max 100) |
Response — 200 OK
Paginated list (credentials never included).
Create Webhook
Endpoint: POST /api/v1/webhooks
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| wallet_id | string | Yes | Wallet UUID |
| network_id | string | Yes | Network UUID |
| host | string | Yes | max 2048 |
| success_path | string | Yes | max 512 |
| error_path | string | Yes | max 512 |
| auth_type | string | Yes | basic or token |
| auth_basic_username | string | No | For auth_type=basic |
| auth_basic_password | string | No | For auth_type=basic |
| auth_token | string | No | For auth_type=token |
Response — 201 Created
| Status | Description |
|---|---|
| 403 | No access to wallet's node |
| 404 | Wallet or network not found |
| 409 | Conflict |
Update Webhook
Endpoint: PUT /api/v1/webhooks
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Webhook UUID |
| host | string | No | max 2048 |
| success_path | string | No | max 512 |
| error_path | string | No | max 512 |
| auth_type | string | No | basic or token |
| auth_basic_username | string | No | — |
| auth_basic_password | string | No | — |
| auth_token | string | No | — |
Response — 200 OK
| Status | Description |
|---|---|
| 403 | No access to webhook's wallet node |
| 404 | Webhook not found |
Delete Webhook
Endpoint: DELETE /api/v1/webhooks
Request Body
{ "id": "550e8400-e29b-41d4-a716-446655440000" }
Response — 204 No Content
| Status | Description |
|---|---|
| 403 | No access to webhook's wallet node |
| 404 | Webhook not found |