curl "https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=YOUR_API_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/email-accounts/tags",
params={"api_key": API_KEY}
)
tags = response.json()
for tag in tags:
print(f"Tag: {tag['name']} (ID: {tag['id']}, Color: {tag['color']})")
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=${API_KEY}`
);
const tags = await response.json();
tags.forEach(tag => {
console.log(`Tag: ${tag.name} (ID: ${tag.id}, Color: ${tag.color})`);
});
[
{
"id": 10,
"name": "Winners",
"color": "#B1FCCF"
},
{
"id": 15,
"name": "Webinar Emails",
"color": "#F5B1FC"
},
{
"id": 22,
"name": "High Priority",
"color": "#FCB1B1"
}
]
{
"ok": false,
"message": "User authentication required."
}
{
"error": "Failed to fetch email account tags."
}
Email Account Tags
Get All Tags
Retrieve all inbox tags belonging to the authenticated user
GET
/
api
/
v1
/
email-accounts
/
tags
curl "https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=YOUR_API_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/email-accounts/tags",
params={"api_key": API_KEY}
)
tags = response.json()
for tag in tags:
print(f"Tag: {tag['name']} (ID: {tag['id']}, Color: {tag['color']})")
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=${API_KEY}`
);
const tags = await response.json();
tags.forEach(tag => {
console.log(`Tag: ${tag.name} (ID: ${tag.id}, Color: ${tag.color})`);
});
[
{
"id": 10,
"name": "Winners",
"color": "#B1FCCF"
},
{
"id": 15,
"name": "Webinar Emails",
"color": "#F5B1FC"
},
{
"id": 22,
"name": "High Priority",
"color": "#FCB1B1"
}
]
{
"ok": false,
"message": "User authentication required."
}
{
"error": "Failed to fetch email account tags."
}
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
string
required
Your SmartLead API key for authentication
curl "https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=YOUR_API_KEY"
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://server.smartlead.ai/api/v1/email-accounts/tags",
params={"api_key": API_KEY}
)
tags = response.json()
for tag in tags:
print(f"Tag: {tag['name']} (ID: {tag['id']}, Color: {tag['color']})")
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(
`https://server.smartlead.ai/api/v1/email-accounts/tags?api_key=${API_KEY}`
);
const tags = await response.json();
tags.forEach(tag => {
console.log(`Tag: ${tag.name} (ID: ${tag.id}, Color: ${tag.color})`);
});
Response Fields
The response is an array of tag objects:number
Unique tag identifier
string
Tag display name
string
Tag color as a hex code (e.g.,
#B1FCCF)Response Codes
Success
Tags retrieved successfully
Unauthorized
Invalid or missing API key
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"
}
]
{
"ok": false,
"message": "User authentication required."
}
{
"error": "Failed to fetch email account tags."
}
