List labels on an inbox | Resend API (unofficial showcase)

1 parameter

inbox_idstringrequired

The UUID of the inbox whose labels you want to list. An email address is not accepted.

1 status code

200Returns the inbox labels in an object with a `data` array, ordered from oldest to newest.

objectstringrequired

Type of the response object.

dataarray<object>required

The labels on the inbox, oldest first.

Error handling

The inbox_id path parameter must be a UUID for an inbox; an email address is not accepted.

import { Client } from "@octridev/resend";

const client = new Client({
  baseUrl: "https://api.resend.com",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.labels.list({ inboxId: "c0a80123-4567-89ab-cdef-0123456789ab" });

{
  "object": "list",
  "data": [
    {
      "id": "7f9c1d2e-4a6b-4c3d-8e15-9b0a7c6d5e34",
      "name": "Urgent",
      "color": "#E93D82",
      "created_at": "2026-08-05T14:07:42.881Z"
    }
  ]
}

Request

Response

Errors