---
title: "List inbox types"
method: GET
path: "/v1/inbox-types"
tags: ["inbox_types"]
---

# List inbox types

`GET /v1/inbox-types`

Lists the workspace's inbox types (id + name). Each id is stable and usable as a message trigger's `inboxTypeId` (config scopeType `inbox`) and as the `inbox_type_id` filter on list conversations. Reserved inbox types return their slug (e.g. `guest`); custom inbox types return their opaque id.

## Query parameters

- `workspace_id` string, required — Workspace to query.

## Response `200`

Every inbox type in the workspace

- object — Every inbox type in the workspace, each with a stable id usable in a message trigger's inboxTypeId.
  - `data` object[], required
    - `id` string, required — Stable inbox type id. Reserved inbox types surface as their slug (e.g. "guest"); custom inbox types surface as their opaque id. Usable directly as a message trigger's `inboxTypeId` (scopeType "inbox") and as the `inbox_type_id` filter on list_conversations.
    - `name` string, required — Human-readable inbox type name.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded

---

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