sisumail.fi

Quickstart

Two tracks: use Sisumail in minutes, or integrate it as a developer.

Before you start

You need:

1. An invite code

2. A public key (for your encrypted payload workflow)

3. A terminal with curl

Track A: Just use it

1. Open /apply.

2. Enter invite code, handle, and public key.

3. Save your API key (shown once).

4. Run this to confirm your account:

curl -sS -H "Authorization: Bearer <API_KEY>" \
  https://sisumail.fi/v1/me/account

Expected: JSON with your username and status active.

Track B: Developer integration

Set environment variables once:

export SISUMAIL_API_KEY="<API_KEY>"
export SISUMAIL_USER="<username>"

Check account:

curl -sS -H "Authorization: Bearer $SISUMAIL_API_KEY" \
  https://sisumail.fi/v1/me/account

Fetch queued messages:

curl -sS -H "Authorization: Bearer $SISUMAIL_API_KEY" \
  https://sisumail.fi/v1/me/messages

Rotate API key:

curl -sS -X POST -H "Authorization: Bearer $SISUMAIL_API_KEY" \
  https://sisumail.fi/v1/me/api-key/rotate

Store the returned key and replace SISUMAIL_API_KEY immediately.

SMTP delivery format

Recipient address formats:

<username>@sisumail.fi

<service>@<username>.sisumail.fi

Payload must start with one of:

ciphertext: or age1 or ENC:

Example (local sendmail-compatible client):

printf 'ciphertext:hello\n' | sendmail "$SISUMAIL_USER@sisumail.fi"

Troubleshooting

401 unauthorized: wrong/missing API key.

400 invite_invalid: invite code is wrong/expired/redeemed.

409 username_taken: handle already claimed.

550 plaintext rejected (SMTP): payload does not look encrypted.