curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/saved-views?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
}
}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/saved-views",
params={"api_key": "CLIENT_API_KEY"},
json={
"name": "All Replies",
"filters": {"emailStatus": "Replied"}
}
)
print(response.json())
{
"success": true,
"data": {
"id": 321,
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
},
"limitedAccess": true,
"teamMemberId": null,
"clientId": null,
"createdAt": "2026-09-29T10:00:00.000Z",
"updatedAt": "2026-09-29T10:00:00.000Z"
}
}
{
"error": "Client does not have permission to modify saved views"
}
Master Inbox
Create Saved View
Create a saved Master Inbox view (a named set of filters)
POST
/
api
/
v1
/
master-inbox
/
saved-views
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/saved-views?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
}
}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/saved-views",
params={"api_key": "CLIENT_API_KEY"},
json={
"name": "All Replies",
"filters": {"emailStatus": "Replied"}
}
)
print(response.json())
{
"success": true,
"data": {
"id": 321,
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
},
"limitedAccess": true,
"teamMemberId": null,
"clientId": null,
"createdAt": "2026-09-29T10:00:00.000Z",
"updatedAt": "2026-09-29T10:00:00.000Z"
}
}
{
"error": "Client does not have permission to modify saved views"
}
With your own API key, the view is created in your account. With a client API key (see Client API Keys), the view is created in that client’s account. This requires the client to have the
full_access permission.Query Parameters
string
required
Your SmartLead API key, or a client API key
Request Body
string
required
View name (1–255 characters)
object
required
The view’s filters. Accepts exactly the same
filters object as Get Custom View Emails: search, leadCategories, emailStatus, campaignId, emailAccountId, campaignTeamMemberId, campaignTagId, campaignClientId, replyTimeBetween, subSequenceId. Any other key is rejected with 400.boolean
default:"true"
Limited access flag stored on the view
curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/saved-views?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
}
}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/master-inbox/saved-views",
params={"api_key": "CLIENT_API_KEY"},
json={
"name": "All Replies",
"filters": {"emailStatus": "Replied"}
}
)
print(response.json())
Response Example
{
"success": true,
"data": {
"id": 321,
"name": "Needs Followup",
"filters": {
"emailStatus": "Replied",
"leadCategories": { "categoryIdsIn": [1, 2] }
},
"limitedAccess": true,
"teamMemberId": null,
"clientId": null,
"createdAt": "2026-09-29T10:00:00.000Z",
"updatedAt": "2026-09-29T10:00:00.000Z"
}
}
{
"error": "Client does not have permission to modify saved views"
}