curl -X POST "https://server.smartlead.ai/api/v1/campaigns/update-folder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_ids": [123, 124], "folder_id": 17412}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/campaigns/update-folder",
params={"api_key": "YOUR_API_KEY"},
json={"campaign_ids": [123, 124], "folder_id": 17412}
)
print(response.json())
{
"ok": true,
"requested": 2,
"updated": 2,
"updated_campaign_ids": [123, 124],
"not_found_campaign_ids": []
}
{
"ok": false,
"error": "Folder not found - Invalid folder_id."
}
{
"ok": false,
"error": "No accessible campaigns for the provided campaign_ids.",
"not_found_campaign_ids": [123, 124]
}
Campaign Management
Move Campaigns to Folder
Move one or more campaigns into a folder, or remove them from their folder
POST
/
api
/
v1
/
campaigns
/
update-folder
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/update-folder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_ids": [123, 124], "folder_id": 17412}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/campaigns/update-folder",
params={"api_key": "YOUR_API_KEY"},
json={"campaign_ids": [123, 124], "folder_id": 17412}
)
print(response.json())
{
"ok": true,
"requested": 2,
"updated": 2,
"updated_campaign_ids": [123, 124],
"not_found_campaign_ids": []
}
{
"ok": false,
"error": "Folder not found - Invalid folder_id."
}
{
"ok": false,
"error": "No accessible campaigns for the provided campaign_ids.",
"not_found_campaign_ids": [123, 124]
}
Query Parameters
string
required
Your SmartLead API key
Request Body
number[]
required
Campaign IDs to move (1–200 positive integers)
number | null
required
Target folder ID. Use
null to remove the campaigns from their current folder.curl -X POST "https://server.smartlead.ai/api/v1/campaigns/update-folder?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_ids": [123, 124], "folder_id": 17412}'
import requests
response = requests.post(
"https://server.smartlead.ai/api/v1/campaigns/update-folder",
params={"api_key": "YOUR_API_KEY"},
json={"campaign_ids": [123, 124], "folder_id": 17412}
)
print(response.json())
Response
number
Number of campaign IDs sent
number
Number of campaigns moved
number[]
Campaign IDs that were moved
number[]
Campaign IDs that were not found in your account
{
"ok": true,
"requested": 2,
"updated": 2,
"updated_campaign_ids": [123, 124],
"not_found_campaign_ids": []
}
{
"ok": false,
"error": "Folder not found - Invalid folder_id."
}
{
"ok": false,
"error": "No accessible campaigns for the provided campaign_ids.",
"not_found_campaign_ids": [123, 124]
}
