Skip to content
Send-only credentials
Sender-side E2EE SDK
HTTPS API

AliasCloak Transactional Mail

Send application notifications to AliasCloak mailboxes without granting your application inbox, chat, file, backup, or mailbox-private-key access.

1. Create a credential

Open the developer portal, continue with a mailbox stored on your device, create a named mail credential, and copy the one-time ac_mail_live_... token.

Open developer portal

Recommended: sender-side E2EE

sendEncrypted() resolves the current recipient public key, creates a fresh ephemeral X25519 sender key and random content key, encrypts the payload locally with AliasCloak's XChaCha20-Poly1305 secretstream format, and uploads ciphertext plus per-recipient key envelopes. AliasCloak never receives the plaintext content.

npm install https://aliascloak.com/sdk/aliascloak-sdk-1.0.0.tgz
import { AliasCloak } from '@aliascloak/sdk'

const client = new AliasCloak({
  token: 'ac_mail_live_…'
})

await client.sendEncrypted({
  to: '[email protected]',
  subject: 'Build complete',
  text: 'Your build finished successfully.'
})

Simple HTTPS mode

For applications that prioritize simplicity, post plaintext over HTTPS. AliasCloak receives it over TLS and immediately encrypts it before durable message storage.

POST https://aliascloak.com/api/v1/mail/send
Authorization: Bearer ac_mail_live_...
Idempotency-Key: notification-12345
Content-Type: application/json

{
  "recipients": ["[email protected]"],
  "subject": "Build complete",
  "text": "Your build finished successfully."
}