Appearance
Send email
POST
/api/emails/send
Create and queue a new outbound email from the requested namespace. Recipients must be verified external destinations or addresses under the same namespace, and the request must include at least one recipient plus either html or text content. 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. If from is omitted, Mailisk sends from outbound-delivery@{namespace}.mailisk.net; sender overrides must belong to the requested namespace. Messages 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
Query Parameters
namespace*
Namespace to send from.
Type
Requiredstring
Example
"mynamespace"Max Length
253Request 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" ], "attachments": [ { "filename": "invoice.pdf", "content_type": "application/octet-stream", "content_base64": "SGVsbG8sIE1haWxpc2sh", "content_id": "logo", "disposition": "string" } ], "reply_to": { "email": "support@mynamespace.mailisk.net", "name": "Support" }, "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"
{
}