Vlozi aliases

A Vlozi alias gives your account a permanent, branded sending address on the vlozi.app domain:

Sweet Dreams Bakery <sweetdreams@vlozi.app>

This is useful if you want your emails to come from a recognisable address without setting up custom domain DNS. The alias is yours — no other tenant can claim the same slug.

Checking availability

Before claiming, check if your preferred slug is available:

GET /comms/v1/aliases/availability?slug=sweetdreams
x-tenant-id: {your-tenant-id}

Response (available):

{
  "available": true,
  "reason": null,
  "normalised": "sweetdreams",
  "preview": "sweetdreams@vlozi.app"
}

Response (taken):

{
  "available": false,
  "reason": "taken",
  "normalised": "sweetdreams",
  "preview": "sweetdreams@vlozi.app"
}

The slug is automatically lowercased and trimmed before checking, so SweetDreams and sweetdreams are treated as the same.

Slug rules

Claiming an alias

POST /comms/v1/aliases/claim
x-tenant-id: {your-tenant-id}
Content-Type: application/json
 
{ "slug": "sweetdreams" }

Success response (200):

{
  "alias": "sweetdreams",
  "fromEmail": "sweetdreams@vlozi.app",
  "chargedCredits": 20
}

Already yours:

{
  "alias": "sweetdreams",
  "fromEmail": "sweetdreams@vlozi.app",
  "alreadyOwned": true
}

Cost

Claiming an alias costs 20 credits, charged once. The alias is permanent — it does not expire and is not subject to monthly renewal.

If your account has fewer than 20 credits, the claim returns 402:

{
  "error": "INSUFFICIENT_CREDITS",
  "balance": 12,
  "required": 20
}

How the alias is used

Once claimed, all emails from your account automatically use the alias in the From address:

From: Sweet Dreams Bakery <sweetdreams@vlozi.app>

Your sender name (from Sender settings) is combined with the alias to form the full From line. The alias is set in vloziAlias in your sender settings row and is read at send time.

You can still override the From address on individual sends by passing "from" in the send request body.

Releasing an alias

You can release your alias at any time:

DELETE /comms/v1/aliases
x-tenant-id: {your-tenant-id}

Response:

{ "released": true }

Once released, your emails revert to the platform default address until you claim a new alias or configure a custom domain.

In the dashboard

Communication → Alias — shows your current alias (or a claim form if you don't have one), displays the full address it produces, and has a Release button.