Create a Tag

Create a new tag in your Lumail account

MethodPOST

/api/v1/tags

Request Examples

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

const { tag } = await lumail.tags.create({ name: "newsletter" });
console.log(tag);

Response Examples

{
  "success": true,
  "tag": {
    "id": "tag_xY3zAb7cDe",
    "name": "newsletter"
  }
}

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

Creates a new tag in your organization to help organize subscribers and create targeted segments for your email campaigns.

Response

Success (200 OK) - Returns the created tag object.
Error (400 Bad Request) - Returned if the tag name is invalid or missing.

Response Fields

Field	Type	Description
`success`	boolean	Indicates if the operation was successful
`tag`	object	The created tag object
`tag.id`	string	Unique identifier for the tag
`tag.name`	string	Name of the tag

Request Schema

{
  "name": "string" // Required: Name of the tag
}

Usage Example

Use this API endpoint to create new tags for your organization, which can help you:

Categorize subscribers based on interests, behavior, or demographics
Set up tags for segmentation and targeting in email campaigns
Organize subscribers for automation workflows
Create logical groupings for reporting and analytics
Implement tag-based features in your application

PreviousGet All Tags NextList All Campaigns