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. 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"
}

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

Powered by VitePress OpenAPI