---
title: "List inbox preview options"
method: GET
path: "/v1/design_studio/inbox_previews/clients"
tags: ["Design Studio emails"]
---

# List inbox preview options

`GET /v1/design_studio/inbox_previews/clients`

Returns the catalog of email clients and devices available for [inbox previews](/messaging/design-studio/emails/qa-in-design-studio/#inbox-preview). 

Use the `id` values returned by this endpoint as `client_ids` when you [send for an inbox preview](/integrations/api/app/tag/design-studio-emails/submitInboxPreview/).

## Response `200`

Successful response

- object
  - `clients` InboxPreviewClient[]
    - `id` string — Identifier to pass in `client_ids` when you send for an inbox preview.
    - `client` string — Name of the email client and device.
    - `os` string — Operating system the client runs on. Look for `(Dark Mode)` if you want to locate preview options for dark mode.
    - `category` 'Mobile' | 'Application' | 'Web' — Where the client renders. `Mobile` is a phone's native mail app, for example the Gmail App on Android devices. `Application` is a desktop native mail app, for example Apple Mail on macOS. `Web` is webmail viewed in a desktop browser, for example Gmail.com in Firefox, and includes a `browser` value.
    - `browser` string — Browser used to render the client. Populates when `category` is `Web`.

## Other responses

- `401` — Unauthorized - missing or invalid API key
- `404` — Inbox previews aren't enabled for your account.
- `429` — Over the App API's shared limit of 10 requests per second per workspace—the same bucket every call in your workspace that isn't separately rate limited draws from, writes included. The response carries a `Retry-After` header.
- `503` — The device catalog is temporarily unavailable. This is transient—retry in a moment.

## Changes

- **2026-09-17** `b2a806105969` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/design_studio/inbox_previews/clients/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/revisions/d9edec5f938c?raw)