> ## Documentation Index
> Fetch the complete documentation index at: https://agentmail.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://agentmail.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://agentmail.manicule.dev/api/mcp.
> Every agent surface: https://agentmail.manicule.dev/.well-known/llms-manifest.json

# List Webhooks (/api-reference/list-webhooks)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1720 · updated: 2026-09-29 -->
Related: [Sign Up](/api-reference/sign-up.md), [Attach Human](/api-reference/attach-human.md), [Verify](/api-reference/verify.md), [List Inboxes](/api-reference/list-inboxes.md), [Create Inbox](/api-reference/create-inbox.md), [Search Inboxes](/api-reference/search-inboxes.md)

# List Webhooks

`GET /v0/inboxes/{inbox_id}/webhooks`

> **CLI:**
> ```bash
> agentmail inboxes webhooks list --inbox-id <inbox_id>
> ```

Base URL: `https://api.agentmail.to`

Base URL: `https://x402.api.agentmail.to`

Base URL: `https://mpp.api.agentmail.to`

Base URL: `https://api.agentmail.eu`

## OpenAPI

```json
{
  "servers": [
    {
      "url": "https://api.agentmail.to",
      "description": "prod"
    },
    {
      "url": "https://x402.api.agentmail.to",
      "description": "prod-x402"
    },
    {
      "url": "https://mpp.api.agentmail.to",
      "description": "prod-mpp"
    },
    {
      "url": "https://api.agentmail.eu",
      "description": "eu-prod"
    }
  ],
  "security": [
    {
      "Bearer": []
    }
  ],
  "securitySchemes": {
    "Bearer": {
      "type": "http",
      "scheme": "bearer"
    }
  },
  "parameters": [
    {
      "name": "inbox_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "description": "The ID of the inbox.",
        "title": "InboxId"
      }
    },
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "description": "Limit of number of items returned.",
        "title": "Limit"
      }
    },
    {
      "name": "page_token",
      "in": "query",
      "required": false,
      "schema": {
        "type": "string",
        "description": "Page token for pagination.",
        "title": "PageToken"
      }
    },
    {
      "name": "ascending",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean",
        "description": "Sort in ascending temporal order.",
        "title": "Ascending"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Response with status 200",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer",
                "description": "Number of items returned.",
                "title": "Count"
              },
              "limit": {
                "type": "integer",
                "description": "Limit of number of items returned.",
                "title": "Limit"
              },
              "next_page_token": {
                "type": "string",
                "description": "Page token for pagination.",
                "title": "PageToken"
              },
              "webhooks": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "webhook_id": {
                      "type": "string",
                      "description": "ID of webhook.",
                      "title": "WebhookId"
                    },
                    "url": {
                      "type": "string",
                      "description": "URL of webhook endpoint.",
                      "title": "Url"
                    },
                    "event_types": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "message.received",
                          "message.received.spam",
                          "message.received.blocked",
                          "message.received.unauthenticated",
                          "message.sent",
                          "message.delivered",
                          "message.bounced",
                          "message.complained",
                          "message.rejected",
                          "message.opened",
                          "domain.verified"
                        ],
                        "title": "EventType"
                      },
                      "description": "Event types for which to send events.",
                      "title": "EventTypes"
                    },
                    "pod_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Pods for which to send events. Maximum 10 per webhook.",
                      "title": "PodIds"
                    },
                    "inbox_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Inboxes for which to send events. Maximum 10 per webhook.",
                      "title": "InboxIds"
                    },
                    "pod_id": {
                      "type": "string",
                      "description": "ID of the pod the webhook belongs to: the pod it was created in, or the pod of the inbox it\nbelongs to. Absent for an organization webhook and on some inbox webhooks. This is not the\nlist of pods it receives events for; see `pod_ids`."
                    },
                    "inbox_id": {
                      "type": "string",
                      "description": "ID of the inbox the webhook belongs to, if it was created for an inbox. This is not the list\nof inboxes it receives events for; see `inbox_ids`."
                    },
                    "secret": {
                      "type": "string",
                      "description": "Secret for webhook signature verification."
                    },
                    "enabled": {
                      "type": "boolean",
                      "description": "Webhook is enabled."
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Time at which webhook was last updated."
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Time at which webhook was created."
                    },
                    "client_id": {
                      "type": "string",
                      "description": "Client ID of webhook.",
                      "title": "ClientId"
                    }
                  },
                  "required": [
                    "webhook_id",
                    "url",
                    "secret",
                    "enabled",
                    "updated_at",
                    "created_at"
                  ],
                  "title": "Webhook"
                },
                "description": "Ordered by `created_at` descending."
              }
            },
            "required": [
              "count",
              "webhooks"
            ],
            "title": "ListWebhooksResponse"
          }
        }
      }
    }
  }
}
```