Skip to main content
POST
/
api
/
v1
/
email-accounts
/
tag-manager
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/tag-manager?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": 1, "name": "Primary Senders", "color": "#4CAF50"}'

{
  "ok": true,
  "data": {
    "id": 1,
    "name": "Primary Senders",
    "color": "#4CAF50"
  }
}
Tags help organize your email accounts into groups for filtering and management. Each tag has a unique color for visual identification.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
id
number
required
Tag ID. Use an existing ID to update, or the system-assigned ID for new tags.
​
name
string
required
Tag display name
​
color
string
required
Hex color code for the tag (e.g., #FF5733). Must be a valid 6-character hex color with # prefix.
curl -X POST "https://server.smartlead.ai/api/v1/email-accounts/tag-manager?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id": 1, "name": "Primary Senders", "color": "#4CAF50"}'

​
Response Codes

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Request validation failed. Check parameter types and constraints.
{
  "ok": true,
  "data": {
    "id": 1,
    "name": "Primary Senders",
    "color": "#4CAF50"
  }
}