---
title: "List all inboxes"
method: GET
path: "/trigger-inbox/v1/inboxes"
tags: ["Inboxes"]
---

# List all inboxes

`GET /trigger-inbox/v1/inboxes`

List all inboxes for the authenticated user.

## Query parameters

- `key` string
- `limit` integer
- `name` string
- `offset` integer
- `status` 'active' | 'deleting' | 'initialization_failure' | 'initializing' | 'paused'

## Response `200`

An inbox: a durable, user-scoped queue for a trigger subscription,
identified by its natural `key`.

- PaginatedInboxList
  - `count` integer, required — Total number of results across all pages.
  - `next` string, uri, nullable — Link to next page of results if any.
  - `previous` string, uri, nullable — Link to previous page of results if any.
  - `results` Inbox[], required — Array of results for the current page.
    - `id` string, uuid, required — The unique identifier for the inbox.
    - `created_at` string, date-time, required — Creation timestamp in ISO 8601 format.
    - `key` string — The inbox's natural key. Set at creation, immutable, unique per user.
    - `name` string — Deprecated alias for `key`. Use `key` instead.
    - `status` string, required — The status of the inbox.
    - `paused_reason` union — The reason the inbox was paused, if applicable. * `user` - user * `authentication` - authentication * `authentication_access_revoked` - authentication_access_revoked * `partner_revoked` - partner_revoked * `subscribe_failed` - subscribe_failed * `migrate_failed` - migrate_failed * `abandoned` - abandoned * `unknown` - unknown * `upstream_failures` - upstream_failures
      - 'user' | 'authentication' | 'authentication_access_revoked' | 'partner_revoked' | 'subscribe_failed' | 'migrate_failed' | 'abandoned' | 'unknown' | 'upstream_failures' — * `user` - user * `authentication` - authentication * `authentication_access_revoked` - authentication_access_revoked * `partner_revoked` - partner_revoked * `subscribe_failed` - subscribe_failed * `migrate_failed` - migrate_failed * `abandoned` - abandoned * `unknown` - unknown * `upstream_failures` - upstream_failures
      - ''
      - unknown
    - `notification_url` string, uri, nullable — URL to POST notifications to when messages become available.
    - `subscription` TriggerSubscription, required — Trigger subscription configuration for an inbox.
      - `connection_id` union — The ID of the connection associated with this inbox.
        - string, uuid
        - integer
      - `app_key` string, required — App identifier. Accepts a fully-versioned selected_api (`SlackCLIAPI@1.0.0`, used as-is), a versionless selected_api (`SlackCLIAPI`), the `@latest` sentinel (`SlackCLIAPI@latest`), or a service slug (`slack`). Versionless, `@latest`, and slug forms are resolved to the latest published version at creation time; the inbox always stores and returns the fully-versioned form. Returns 400 if the identifier matches no app or is ambiguous (matches more than one).
      - `action_key` string, required — The key of the app action associated with this inbox.
      - `inputs` object, required — The inputs provided to the app action associated with this inbox.

## Other responses

- `400` — Validation Error: Return fields with errors.
- `429` — Too many requests.

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)