# Webhook

> The Webhook object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `id` * | string |  |
| `workspace_id` * | string |  |
| `url` * | string (uri) |  |
| `description` | string or null |  |
| `events` * | array of [WebhookEventType](/docs/api/objects/webhook-event-type/) |  |
| `project_ids` | array of string or null |  |
| `enabled` * | boolean |  |
| `secret_prefix` | string |  |
| `last_delivery` | object or null |  |
| `created_at` * | string (date-time) |  |
| `updated_at` | string (date-time) |  |

\* always present

## Example

```json
{
  "id": "whk_01jbx2m9k7q4r8t5v6w3y0z1pr",
  "workspace_id": "string",
  "url": "https://guv.dev/",
  "description": "string",
  "events": [
    "deployment.created"
  ],
  "project_ids": [
    "string"
  ],
  "enabled": false,
  "secret_prefix": "whsec_Ab3d",
  "last_delivery": {
    "status": "string",
    "at": "2026-10-22T13:05:00Z"
  },
  "created_at": "2026-10-22T13:05:00Z",
  "updated_at": "2026-10-22T13:05:00Z"
}
```

## Used by

- [Get a webhook](/docs/api/webhooks/#get-a-webhook)
- [Update a webhook](/docs/api/webhooks/#update-a-webhook)