Sender settings

Sender settings control how your emails appear to recipients: the display name in the "From" field, the reply-to address, and the brand elements (logo and colour) used in email templates.

Configuration fields

Setting up via dashboard

Communication → Sender Settings

Fill in your business name and reply-to address. These take effect immediately on the next email sent.

Via the API

Get current settings:

GET /comms/v1/sender-settings
x-tenant-id: {your-tenant-id}

Response:

{
  "settings": {
    "tenantId": "tenant_abc",
    "senderName": "Sweet Dreams Bakery",
    "senderEmail": "orders@sweetdreams.in",
    "fromEmail": null,
    "phoneNumber": null,
    "vloziAlias": "sweetdreams",
    "brandLogoUrl": "https://cdn.sweetdreams.in/logo.png",
    "brandPrimaryColor": "#FF5436"
  }
}

Update settings (partial — only fields you include are changed):

PUT /comms/v1/sender-settings
x-tenant-id: {your-tenant-id}
Content-Type: application/json
 
{
  "sender_name": "Sweet Dreams Bakery",
  "sender_email": "orders@sweetdreams.in",
  "brand_logo_url": "https://cdn.sweetdreams.in/logo.png",
  "brand_primary_color": "#FF5436"
}

The PUT uses partial update semantics:

• Fields you include are written
• Fields you omit are left unchanged
• Pass null explicitly to clear a field

Clear a field:

PUT /comms/v1/sender-settings
Content-Type: application/json
 
{ "brand_logo_url": null }

Sender name and reply-to

sender_name appears as the display name in recipients' inboxes:

From: Sweet Dreams Bakery <hello@vlozi.app>
Reply-To: orders@sweetdreams.in

If a customer replies to your email, their client sends the reply to sender_email (your reply-to), not to the Vlozi sending address. This keeps your business email address visible to customers.

From address vs reply-to

By default, all emails are sent from the Vlozi domain even if sender_name is set. The from_email field (custom domain) allows you to send from your own domain, but the domain must be verified through your DNS settings first. Contact support to set up custom domain sending.

If you have a Vlozi alias, emails go out as {senderName} <alias@vlozi.app> — no DNS changes needed.

Brand kit

brand_logo_url and brand_primary_color are used in Vlozi's default email templates:

• The logo appears at the top of newsletter emails
• The primary colour is used for buttons and accents
• Newsletter templates automatically pull these values via {{ brand.logo_url }} and {{ brand.primary_color }}

Supported colour formats: #RGB (e.g., #F53) and #RRGGBB (e.g., #FF5436)