curl -X POST "https://server.smartlead.ai/api/v1/campaigns/12345/forward-email?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"message_id": "msg-abc-123",
"stats_id": "stats-abc-123",
"to_emails": "manager@company.com,sales@company.com",
"cc_emails": "teamlead@company.com",
"bcc_emails": "audit@company.com",
"forward_email_subject": "FYI – please review",
"forward_email_body": "<p>Sharing this thread for your visibility.</p>"
}'
import requests
API_KEY = "YOUR_API_KEY"
def forward_email(
campaign_id,
message_id,
stats_id,
to_emails,
forward_email_body=None,
forward_email_subject=None,
cc_emails=None,
bcc_emails=None,
):
"""Forward an email to other recipients"""
payload = {
"message_id": message_id,
"stats_id": stats_id,
"to_emails": to_emails,
}
if forward_email_body is not None:
payload["forward_email_body"] = forward_email_body
if forward_email_subject is not None:
payload["forward_email_subject"] = forward_email_subject
if cc_emails is not None:
payload["cc_emails"] = cc_emails
if bcc_emails is not None:
payload["bcc_emails"] = bcc_emails
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/forward-email",
params={"api_key": API_KEY},
json=payload,
)
return response.json()
# Forward with default subject and body (backwards-compatible)
forward_email(
campaign_id=12345,
message_id="msg-abc-123",
stats_id="stats-abc-123",
to_emails="manager@company.com",
)
# Forward with custom subject and body
forward_email(
campaign_id=12345,
message_id="msg-abc-124",
stats_id="stats-abc-124",
to_emails="sales@company.com,support@company.com",
cc_emails="teamlead@company.com",
bcc_emails="audit@company.com",
forward_email_subject="FYI – please review",
forward_email_body="<p>Sharing this thread for your visibility.</p>",
)
const API_KEY = 'YOUR_API_KEY';
async function forwardEmail(campaignId, body) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/forward-email?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(body),
}
);
return response.json();
}
// Forward with default subject and body (backwards-compatible)
await forwardEmail(12345, {
message_id: 'msg-abc-123',
stats_id: 'stats-abc-123',
to_emails: 'manager@company.com',
});
// Forward with custom subject and body
await forwardEmail(12345, {
message_id: 'msg-abc-124',
stats_id: 'stats-abc-124',
to_emails: 'sales@company.com,support@company.com',
cc_emails: 'teamlead@company.com',
bcc_emails: 'audit@company.com',
forward_email_subject: 'FYI – please review',
forward_email_body: '<p>Sharing this thread for your visibility.</p>',
});
{
"ok": true,
"messageId": "<generated-message-id@smartlead.ai>",
"status": "success"
}
{
"statusCode": 400,
"error": "Bad Request",
"message": "\"forward_email_body\" must be a string"
}
{
"ok": false,
"error": "Email account not found!",
"status": "error"
}
Master Inbox
Forward Email
Forward an email to other recipients
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
forward-email
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/12345/forward-email?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"message_id": "msg-abc-123",
"stats_id": "stats-abc-123",
"to_emails": "manager@company.com,sales@company.com",
"cc_emails": "teamlead@company.com",
"bcc_emails": "audit@company.com",
"forward_email_subject": "FYI – please review",
"forward_email_body": "<p>Sharing this thread for your visibility.</p>"
}'
import requests
API_KEY = "YOUR_API_KEY"
def forward_email(
campaign_id,
message_id,
stats_id,
to_emails,
forward_email_body=None,
forward_email_subject=None,
cc_emails=None,
bcc_emails=None,
):
"""Forward an email to other recipients"""
payload = {
"message_id": message_id,
"stats_id": stats_id,
"to_emails": to_emails,
}
if forward_email_body is not None:
payload["forward_email_body"] = forward_email_body
if forward_email_subject is not None:
payload["forward_email_subject"] = forward_email_subject
if cc_emails is not None:
payload["cc_emails"] = cc_emails
if bcc_emails is not None:
payload["bcc_emails"] = bcc_emails
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/forward-email",
params={"api_key": API_KEY},
json=payload,
)
return response.json()
# Forward with default subject and body (backwards-compatible)
forward_email(
campaign_id=12345,
message_id="msg-abc-123",
stats_id="stats-abc-123",
to_emails="manager@company.com",
)
# Forward with custom subject and body
forward_email(
campaign_id=12345,
message_id="msg-abc-124",
stats_id="stats-abc-124",
to_emails="sales@company.com,support@company.com",
cc_emails="teamlead@company.com",
bcc_emails="audit@company.com",
forward_email_subject="FYI – please review",
forward_email_body="<p>Sharing this thread for your visibility.</p>",
)
const API_KEY = 'YOUR_API_KEY';
async function forwardEmail(campaignId, body) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/forward-email?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(body),
}
);
return response.json();
}
// Forward with default subject and body (backwards-compatible)
await forwardEmail(12345, {
message_id: 'msg-abc-123',
stats_id: 'stats-abc-123',
to_emails: 'manager@company.com',
});
// Forward with custom subject and body
await forwardEmail(12345, {
message_id: 'msg-abc-124',
stats_id: 'stats-abc-124',
to_emails: 'sales@company.com,support@company.com',
cc_emails: 'teamlead@company.com',
bcc_emails: 'audit@company.com',
forward_email_subject: 'FYI – please review',
forward_email_body: '<p>Sharing this thread for your visibility.</p>',
});
{
"ok": true,
"messageId": "<generated-message-id@smartlead.ai>",
"status": "success"
}
{
"statusCode": 400,
"error": "Bad Request",
"message": "\"forward_email_body\" must be a string"
}
{
"ok": false,
"error": "Email account not found!",
"status": "error"
}
Forward email threads to colleagues or external recipients. Maintains original context and thread history.
Overview
Forwards an email to specified recipients. Useful for collaboration, escalation, and sharing important conversations. Use Cases:- Escalate to manager/supervisor
- Share with team members
- Forward to subject matter expert
- Loop in decision makers
- External referrals
Path Parameters
integer
required
Campaign ID
Query Parameters
string
required
Your SmartLead API key
Request Body
string
required
Message ID to forward
string
required
Email stats ID
string
required
Comma-separated recipient email addresses.
string
Custom HTML or plain-text body prepended above the auto-generated forwarded message chain. Mirrors the “compose” textbox in the Global Inbox UI when forwarding from the app. When omitted, only the auto-generated forwarded chain is sent.
string
Custom subject line for the forwarded email. Overrides the original campaign’s subject when provided. When omitted, the original campaign subject is used.
string
Optional comma-separated CC recipient email addresses.
string
Optional comma-separated BCC recipient email addresses.
forward_email_body, forward_email_subject, cc_emails, and bcc_emails are optional. Existing integrations that send only message_id, stats_id, and to_emails are fully backwards-compatible — behaviour is unchanged when these fields are omitted.curl -X POST "https://server.smartlead.ai/api/v1/campaigns/12345/forward-email?api_key=YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"message_id": "msg-abc-123",
"stats_id": "stats-abc-123",
"to_emails": "manager@company.com,sales@company.com",
"cc_emails": "teamlead@company.com",
"bcc_emails": "audit@company.com",
"forward_email_subject": "FYI – please review",
"forward_email_body": "<p>Sharing this thread for your visibility.</p>"
}'
import requests
API_KEY = "YOUR_API_KEY"
def forward_email(
campaign_id,
message_id,
stats_id,
to_emails,
forward_email_body=None,
forward_email_subject=None,
cc_emails=None,
bcc_emails=None,
):
"""Forward an email to other recipients"""
payload = {
"message_id": message_id,
"stats_id": stats_id,
"to_emails": to_emails,
}
if forward_email_body is not None:
payload["forward_email_body"] = forward_email_body
if forward_email_subject is not None:
payload["forward_email_subject"] = forward_email_subject
if cc_emails is not None:
payload["cc_emails"] = cc_emails
if bcc_emails is not None:
payload["bcc_emails"] = bcc_emails
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/forward-email",
params={"api_key": API_KEY},
json=payload,
)
return response.json()
# Forward with default subject and body (backwards-compatible)
forward_email(
campaign_id=12345,
message_id="msg-abc-123",
stats_id="stats-abc-123",
to_emails="manager@company.com",
)
# Forward with custom subject and body
forward_email(
campaign_id=12345,
message_id="msg-abc-124",
stats_id="stats-abc-124",
to_emails="sales@company.com,support@company.com",
cc_emails="teamlead@company.com",
bcc_emails="audit@company.com",
forward_email_subject="FYI – please review",
forward_email_body="<p>Sharing this thread for your visibility.</p>",
)
const API_KEY = 'YOUR_API_KEY';
async function forwardEmail(campaignId, body) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/forward-email?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(body),
}
);
return response.json();
}
// Forward with default subject and body (backwards-compatible)
await forwardEmail(12345, {
message_id: 'msg-abc-123',
stats_id: 'stats-abc-123',
to_emails: 'manager@company.com',
});
// Forward with custom subject and body
await forwardEmail(12345, {
message_id: 'msg-abc-124',
stats_id: 'stats-abc-124',
to_emails: 'sales@company.com,support@company.com',
cc_emails: 'teamlead@company.com',
bcc_emails: 'audit@company.com',
forward_email_subject: 'FYI – please review',
forward_email_body: '<p>Sharing this thread for your visibility.</p>',
});
Response Example
{
"ok": true,
"messageId": "<generated-message-id@smartlead.ai>",
"status": "success"
}
{
"statusCode": 400,
"error": "Bad Request",
"message": "\"forward_email_body\" must be a string"
}
{
"ok": false,
"error": "Email account not found!",
"status": "error"
}
Related Endpoints
⌘I
