---
title: Webhooks
---

## List Webhooks
Agentry API endpoint.
**Endpoint**: `GET /human/v0/webhooks`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `ascending` | query | boolean | No |  |
| `inbox_id` | query | string | No |  |
| `limit` | query | integer | No |  |
| `page_token` | query | string | No |  |

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | Yes |  |
| `limit` | integer | Yes |  |
| `next_page_token` | string | No |  |
| `webhooks` | array\<object\> | Yes |  |

##### Example

```json
{
  "count": 0,
  "limit": 0,
  "next_page_token": "<string>",
  "webhooks": [
    {
      "created_at": "2026-01-01T00:00:00Z",
      "enabled": true,
      "enrichment_policy": {},
      "event_types": [
        "message.received"
      ],
      "inbox_id": "<string>",
      "secret": "<string>",
      "target_url": "https://example.com",
      "updated_at": "2026-01-01T00:00:00Z",
      "webhook_id": "<string>"
    }
  ]
}
```


## Create Webhook
Agentry API endpoint.
**Endpoint**: `POST /human/v0/webhooks`
**Authentication**: `Authorization: Bearer <token>`
### Request Body
Content-Type: `application/json`
#### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `enrichment_policy` | object | No |  |
| `event_types` | array\<`message.received`\> | Yes | Human webhook event types. |
| `inbox_id` | string | No |  |
| `target_url` | string | Yes |  |

#### Example

```json
{
  "enrichment_policy": {},
  "event_types": [
    "message.received"
  ],
  "inbox_id": "<string>",
  "target_url": "https://example.com"
}
```

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `created_at` | string | Yes |  |
| `enabled` | boolean | Yes |  |
| `enrichment_policy` | object | No |  |
| `event_types` | array\<`message.received`\> | Yes | Human webhook event types. |
| `inbox_id` | string | Yes |  |
| `secret` | string | Yes |  |
| `target_url` | string | Yes |  |
| `updated_at` | string | Yes |  |
| `webhook_id` | string | Yes |  |

##### Example

```json
{
  "created_at": "2026-01-01T00:00:00Z",
  "enabled": true,
  "enrichment_policy": {},
  "event_types": [
    "message.received"
  ],
  "inbox_id": "<string>",
  "secret": "<string>",
  "target_url": "https://example.com",
  "updated_at": "2026-01-01T00:00:00Z",
  "webhook_id": "<string>"
}
```


## Update Webhook
Agentry API endpoint.
**Endpoint**: `PATCH /human/v0/webhooks/{webhook_id}`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `webhook_id` | path | string | Yes |  |

### Request Body
Content-Type: `application/json`
#### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `enabled` | boolean | No |  |
| `enrichment_policy` | object | No |  |
| `event_types` | array\<`message.received`\> | No | Human webhook event types. |
| `target_url` | string | No |  |

#### Example

```json
{
  "enabled": true,
  "enrichment_policy": null,
  "event_types": [
    "message.received"
  ],
  "target_url": "https://example.com"
}
```

### Responses

#### `200`

Successful response

Content-Type: `application/json`

##### Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `created_at` | string | Yes |  |
| `enabled` | boolean | Yes |  |
| `enrichment_policy` | object | No |  |
| `event_types` | array\<`message.received`\> | Yes | Human webhook event types. |
| `inbox_id` | string | Yes |  |
| `secret` | string | Yes |  |
| `target_url` | string | Yes |  |
| `updated_at` | string | Yes |  |
| `webhook_id` | string | Yes |  |

##### Example

```json
{
  "created_at": "2026-01-01T00:00:00Z",
  "enabled": true,
  "enrichment_policy": {},
  "event_types": [
    "message.received"
  ],
  "inbox_id": "<string>",
  "secret": "<string>",
  "target_url": "https://example.com",
  "updated_at": "2026-01-01T00:00:00Z",
  "webhook_id": "<string>"
}
```


## Delete Webhook
Agentry API endpoint.
**Endpoint**: `DELETE /human/v0/webhooks/{webhook_id}`
**Authentication**: `Authorization: Bearer <token>`
### Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `webhook_id` | path | string | Yes |  |

### Responses

#### `204`

Successful response