Mail
API keys
Create, manage, and revoke Mail API keys for programmatic email sending.
Mail API keys authenticate your requests to the Vorynza Mail send API. Each key is scoped to specific permissions.
Creating an API key
API keys are created per mail service from the dashboard. Each key has a name for identification and a scope that controls what the key can do.
Scopes
| Scope | Description |
|---|---|
mail:send | Send email through the API |
mail:read | Read message delivery status |
The full key is displayed once after creation:
vnz_mail_abc123_def456...Store it securely — it cannot be retrieved later.
Key format
vnz_mail_<prefix>_<secret>Keys are hashed with SHA-256 before storage. The raw key is never persisted.
Using API keys
Include the API key as a Bearer token in the Authorization header:
curl -X POST https://api.vorynza.cloud/v1/mail/send \
-H "Authorization: Bearer vnz_mail_your_api_key" \
-H "Content-Type: application/json" \
-d '{ ... }'Revoking a key
Revoked keys immediately stop working. You can create new keys at any time.
Need help? Contact support.