---
title: "List Polling Webhooks"
method: GET
path: "/v0/inboxes/{inbox_id}/webhooks/polling"
tags: ["inboxes > webhooks > polling"]
---

# List Polling Webhooks

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

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/inboxes/{inbox_id}/webhooks/polling`
- Auth: HTTP bearer

Lists the polling webhooks created through this inbox route.

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

## Path parameters

- `inbox_id` string, required: The ID of the inbox.

## Query parameters

- `limit` integer: Limit of number of items returned.
- `page_token` string: Page token for pagination.
- `ascending` boolean: Sort in ascending temporal order.

## Response `200`

Response with status 200

- WebhooksPollingListPollingWebhooksResponse
  - `count` integer, required: Number of items returned.
  - `limit` integer: Limit of number of items returned.
  - `next_page_token` string: Page token for pagination.
  - `polling_webhooks` WebhooksPollingPollingWebhook[], required: Ordered by `created_at` descending. Lists the subscriptions created through this route (organization, pod, or inbox); subscriptions created through a pod or inbox route are listed through that route.
    - `webhook_id` string, required: ID of webhook.
    - `client_id` string, required: Client ID of webhook.
    - `event_types` EventsEventType[], required: Event types for which to send events.
    - `pod_ids` string[]: Pods for which to send events.
    - `inbox_ids` string[]: Inboxes for which to send events.
    - `pod_id` string: ID of the pod the subscription belongs to: the pod it was created in, or the pod of the inbox it belongs to. Absent for an organization subscription. This is not the list of pods it receives events for; see `pod_ids`.
    - `inbox_id` string: ID of the inbox the subscription belongs to, if it was created for an inbox. This is not the list of inboxes it receives events for; see `inbox_ids`.
    - `updated_at` string, date-time, required: Time at which the subscription was last updated.
    - `created_at` string, date-time, required: Time at which the subscription was created.

## Other responses

- `400`: Error response with status 400

## Changes

- **2026-10-16** `3f5c7830c952`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/inboxes/:inbox_id/webhooks/polling/get.md)

---

[API](https://skmtc.dev/agentmail-to/apis/api.md) - [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentmail-to/apis/api/revisions/a9792efe7bdf?raw)