---
title: "List Webhooks"
method: GET
path: "/api/v1/webhooks"
tags: ["Webhooks"]
---

# List Webhooks

`GET /api/v1/webhooks`

Retrieve all registered webhook endpoints for the authenticated user.

**Response Data:**
Returns a list of webhook objects containing:
- `webhook_id`: Unique identifier for each webhook
- `webhook_url`: The URL endpoint for receiving webhooks
- `events`: Array of subscribed event types
- `status`: Current webhook status (active, inactive, disabled)
- `created_at`: Registration timestamp

**Webhook Statuses:**
- `active`: Webhook is active and receiving events
- `inactive`: Webhook is temporarily disabled
- `disabled`: Webhook is permanently disabled due to failures

**Available Events:**
- `memory_processing_started`: Triggered when memory processing begins
- `memory_completed`: Triggered when memory processing completes successfully
- `memory_failed`: Triggered when memory processing fails

**Use Cases:**
- Review all registered webhook endpoints
- Monitor webhook status and health
- Audit webhook configurations
- Manage webhook subscriptions

**Response Format:**
Returns a simple success response with webhook data array. No pagination is currently implemented.

## Response `200`

List of registered webhooks

- WebhookListSuccessResponse — Webhook list success response (HTTP 200)
  - `success` boolean — Operation success status - always true for successful responses
  - `data` WebhookListItem[], required — List of registered webhooks
    - `webhook_id` string, required — Unique webhook identifier
    - `webhook_url` string, required — The URL to send webhook events to
    - `events` string[], required — List of subscribed events
    - `status` string, required — Webhook status
    - `created_at` string, date-time, required — Webhook creation timestamp

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/neosapien/apis/neocore.md) · [All operations](https://skmtc.dev/neosapien/apis/neocore/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neosapien/neocore/revisions/8b94ef58f2cf/schema)