List Webhooks

Retrieve all webhooks configured for your organization

This endpoint returns a list of all webhooks configured for your organization. Use this to audit your webhook configurations and retrieve webhook details including HMAC keys for signature verification.

Use Cases

• Audit webhook configurations
• Retrieve HMAC keys for signature verification
• List active webhook destinations
• Monitor webhook settings

Response

Returns a Result object containing an array of webhook configurations.

data · array

Array of webhook objects

data[].id · string

Unique identifier for the webhook

data[].created_at · string

ISO 8601 timestamp when the webhook was created

data[].destination · string

The URL endpoint where webhook events will be sent

data[].version · string

Webhook API version (e.g., “2024-10-22”)

data[].config · string

JSON string containing webhook configuration including sampleRate, propertyFilters, and includeData settings

data[].hmac_key · string

HMAC key used to sign webhook requests for verification

error · string | null

Error message if the request failed, null otherwise

Example Request

curl --request GET \
  --url https://api.helicone.ai/v1/webhooks \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

Example Response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2024-01-15T10:30:00Z",
      "destination": "https://example.com/webhook",
      "version": "2024-10-22",
      "config": "{\"sampleRate\":100,\"propertyFilters\":[],\"includeData\":true}",
      "hmac_key": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
    }
  ],
  "error": null
}

Configuration Object

The config field contains a JSON string with the following properties:

• sampleRate: Percentage of requests to send (0-100)
• propertyFilters: Array of property filters to match specific requests
• includeData: Whether to include full request/response data in webhook payload