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

# Api Webhooks List

`GET /api/webhooks/`

GET /api/webhooks/ - List all webhooks for organization
POST /api/webhooks/ - Create a new webhook

Query Parameters (GET):
    - Standard list/filter params

Request Body (POST):
    - url (string, required): Webhook URL
    - name (string, required): Webhook name
    - event_type (string, required): Event type (request_log, on_eval_result_ingested, trace_completed)
    - organization_key (int, optional): Scope to specific API key
    - active (boolean, optional): Active status (default: true)

Response:
    - List: Array of webhook objects (secrets excluded)
    - Create: Created webhook object with auto-generated secret (secrets included)

## Headers

- `Authorization` string, required

## Response `200`

- WebhookList[]
  - `id` integer, required
  - `project` string, nullable
  - `url` string, uri, required
  - `name` string
  - `created` string, date-time
  - `event_type` union
    - 'request_log' | 'on_eval_result_ingested' | 'trace_completed' | 'customer_budget_limit_reached' | 'credit_low_balance_threshold_reached' | 'spend_cap_warning_threshold_reached' | 'limit_policy_soft_triggered' | 'limit_policy_hard_triggered' — * `request_log` - Request Log * `on_eval_result_ingested` - Evaluation Result * `trace_completed` - Trace Completed * `customer_budget_limit_reached` - Customer Budget Limit Reached * `credit_low_balance_threshold_reached` - Credit Low Balance Threshold Reached * `spend_cap_warning_threshold_reached` - Spend Cap Warning Threshold Reached * `limit_policy_soft_triggered` - Limit Policy Soft Triggered * `limit_policy_hard_triggered` - Limit Policy Hard Triggered
    - ''
  - `active` boolean
  - `organization` integer, required
  - `organization_key` string, nullable

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)