Lumail.ioLumail.io
DocsBlogChangelog

Getting Started

  • Introduction
  • Tutorials
  • API Reference
  • Integrations
  • Features
  • Workflows

Tutorials

  • Create an API Token
  • Build a V0 Capture Page
  • Dynamic Promo Codes with Webhooks

API Reference

  • API Tokens
  • Rate Limits
  • POSTSend Transactional Email
  • POSTEmail Verification API
  • POSTCreate Subscriber
  • GETGet Subscriber
  • PATCHUpdate Subscriber
  • DELETEDelete Subscriber
  • POSTAdd Tags to Subscriber
  • DELETERemove Tags from Subscriber
  • POSTTrack Event
  • GETGet Subscriber Events
  • GETGet All Tags
  • POSTCreate a Tag
  • Send Email in HTML
  • Send Email in Markdown
  • Send Email in Tiptap

Integrations

  • ClickFunnels Integration
  • SystemIO Integration

Features

  • Variables
  • Subscriber Events
  • Revenue Tracking
  • Email Deliverability Score
  • Email Engagement Score
  • Content Deliverability Checker

Workflows

  • Wait Step
  • Email Step
  • Action Step
  • Webhook Step

domains

  • Email Domains
  • Web Domains

Create a Tag

Create a new tag in your Lumail account

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

FieldTypeDescription
successbooleanIndicates if the operation was successful
tagobjectThe created tag object
tag.idstringUnique identifier for the tag
tag.namestringName 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
Get All TagsSend Email in HTML

Method

POST

Endpoint

/api/v1/tags

Request Examples

curl -X POST https://lumail.io/api/v1/tags \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "newsletter"}'

Response Examples

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

On This Page

ResponseResponse FieldsRequest SchemaUsage Example

Lumail.io

Create and send e-mail without paying thousands of dollars

Product

BlogDocumentationChangelogDashboard

Company

AboutAccount

Legal

TermsPrivacy

8 The Green STE B, Dover Delaware 19901, United States

© 2025 Codelynx, LLC. All rights reserved.

Sign in