Skip to main content
GET
/
api
/
v1
/
email-accounts
/
tags
curl "https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=YOUR_API_KEY"

[
  {
    "id": 10,
    "name": "Winners",
    "color": "#B1FCCF"
  },
  {
    "id": 15,
    "name": "Webinar Emails",
    "color": "#F5B1FC"
  },
  {
    "id": 22,
    "name": "High Priority",
    "color": "#FCB1B1"
  }
]
Returns all tags created by the user, independent of which email accounts they are assigned to. Use this to get a master list of available tags for filtering or display purposes.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key for authentication
curl "https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=YOUR_API_KEY"

​
Response Fields

The response is an array of tag objects:
​
id
number
Unique tag identifier
​
name
string
Tag display name
​
color
string
Tag color as a hex code (e.g., #B1FCCF)

​
Response Codes

​
200
Success
Tags retrieved successfully
​
401
Unauthorized
Invalid or missing API key
​
500
Internal Server Error
Server error occurred
[
  {
    "id": 10,
    "name": "Winners",
    "color": "#B1FCCF"
  },
  {
    "id": 15,
    "name": "Webinar Emails",
    "color": "#F5B1FC"
  },
  {
    "id": 22,
    "name": "High Priority",
    "color": "#FCB1B1"
  }
]