Skip to content

Forward an email​

POST
/api/emails/{emailId}/forward

Create and queue a forwarded copy of an existing inbound email. Mailisk derives the sender namespace from the source email. The to list is required, optional html or text content is prepended before the forwarded message, and recipients must be verified external destinations or same-namespace addresses. Attachments can be included by passing base64 encoded file bytes in attachments[].content_base64; use application/octet-stream when the file should be preserved as a downloadable attachment. Forwards sent only to same-namespace recipients do not consume outbound usage because they are counted as inbound email when delivered.

Authorizations​

ApiKey
Type
API Key (header: X-Api-Key)

Parameters​

Path Parameters

emailId*
Type
string
Required

Request Body​

application/json
JSON
{
  
"from": {
  
  
"email": "support@mynamespace.mailisk.net",
  
  
"name": "Support"
  
},
  
"to": [
  
  
"verified@example.com"
  
],
  
"cc": [
  
  
"optional@example.com"
  
],
  
"bcc": [
  
  
"optional-bcc@example.com"
  
],
  
"subject": "string",
  
"html": "string",
  
"text": "string",
  
"attachments": [
  
  
{
  
  
  
"filename": "invoice.pdf",
  
  
  
"content_type": "application/octet-stream",
  
  
  
"content_base64": "SGVsbG8sIE1haWxpc2sh",
  
  
  
"content_id": "logo",
  
  
  
"disposition": "string"
  
  
}
  
]
}

Responses​

application/json
JSON
{
  
"id": "string",
  
"organisation_id": "string",
  
"type": "string",
  
"status": "string",
  
"from": {
  
  
"email": "support@mynamespace.mailisk.net",
  
  
"name": "Support"
  
},
  
"reply_to": {
  
  
"email": "support@mynamespace.mailisk.net",
  
  
"name": "Support"
  
},
  
"subject": "string",
  
"recipient_count": 0,
  
"attachment_count": 0,
  
"message_id": "string",
  
"provider": "string",
  
"provider_message_id": "string",
  
"failure_reason": "string",
  
"queued_at": "string",
  
"sending_at": "string",
  
"sent_at": "string",
  
"failed_at": "string",
  
"created_at": "string",
  
"updated_at": "string"
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​