Skip to main content
GET
/
api
/
v2
/
webhooks
/
{webhook_id}
Retrieve a webhook
curl --request GET \
  --url https://agp.eu.hcompany.ai/api/v2/webhooks/{webhook_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "url": "<string>",
  "enabled_events": [
    "<string>"
  ],
  "description": {},
  "disabled": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}
Fetches one webhook. The signing secret is never returned by reads; it appears only in the Create response. Returns the webhook object.

​
Path parameters

​
webhook_id
string
required
The webhook’s id (UUID).

​
The webhook object

​
id
string
Unique identifier (UUID).
​
url
string
Target URL for deliveries.
​
enabled_events
string[]
Event types delivered to this webhook; ["*"] means all types.
​
description
string | null
Optional label.
​
disabled
boolean
When true, the webhook stays registered but receives no deliveries.
​
created_at
string
Creation time (UTC).
​
updated_at
string
Last modification time (UTC).

​
Examples

curl https://agp.eu.hcompany.ai/api/v2/webhooks/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer $HAI_API_KEY"
Response
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "url": "https://example.com/hooks/h",
  "enabled_events": ["session.status_updated"],
  "description": "Production listener",
  "disabled": false,
  "created_at": "2026-06-11T15:04:05Z",
  "updated_at": "2026-06-11T15:04:05Z"
}

​
Errors

StatusCause
404Webhook not found or you don’t have access.