Get All Tags

Retrieve a list of all tags in your Lumail account

MethodGET

/api/v1/tags

Request Examples

import { Lumail } from "lumail";
const lumail = new Lumail({ apiKey: "YOUR_API_TOKEN" });

const { tags } = await lumail.tags.list();
console.log(tags);

Response Examples

{
  "success": true,
  "tags": [
    {
      "id": "tag_JqaddtEx7z",
      "name": "newsletter"
    },
    {
      "id": "tag_rdEPhyjnfA",
      "name": "promotional"
    },
    {
      "id": "tag_kL9pqRs2tU",
      "name": "welcome-sequence"
    }
  ]
}

https://lumail.io/api/v1/tags

Retrieves all tags for your organization to help you categorize subscribers and target specific audiences for your campaigns.

Response

Success (200 OK) - Returns an array of tag objects.

Response Fields

Field	Type	Description
`success`	boolean	Indicates if the operation was successful
`tags`	array	Array of tag objects
`tags[].id`	string	Unique identifier for the tag
`tags[].name`	string	Name of the tag

Request Schema

No request body is required for this endpoint.

Usage Example

Use this API endpoint to retrieve all tags in your organization, which can help you:

Display all available tags in your application UI
Create dropdown menus for tag selection in forms
Sync tags between different systems or applications
Get tag IDs needed for other API operations such as adding tags to subscribers
Build tag-based filtering and segmentation tools

PreviousGet Subscriber Events NextCreate a Tag