White-Label Setup Guide

This guide walks you through all required configuration steps to deploy your fully branded SMS service to your clients.

Getting Started

Welcome to the NestSMS White-Label platform. Complete each step in order — skipping steps may cause configuration errors that are difficult to diagnose.

Step 1: Navigate to Settings

From your Dashboard, follow these instructions:

1. Make sure you are in the dashboard
2. In your left sidebar, click on the Settings icon (gear symbol)
3. From the settings menu, access your organization settings

Step 2: Set Primary Color

On the Organizations settings page, scroll down to the Branding section.

Setting the Primary Color

1. Locate the Primary Color field
2. Enter your brand's hex color code (e.g. #1A73E8) or use the color picker
3. The color will be applied across your white-labeled portal — buttons, navbar, and accents

Step 3: Create CNAME Records at Your DNS Provider

Log in to your domain DNS provider and create two CNAME records pointing to our platform:

Replace yourdomain.com with your actual domain.

Step 4: Enter Frontend CNAME in Settings

Back in Settings → Organizations, scroll to the Domain Configuration section.

1. In the Frontend URL field, enter the full URL of your frontend CNAME:

   https://app.yourdomain.com

2. Replace app.yourdomain.com with your actual subdomain and domain

Step 5: Enter Backend CNAME in Settings

In the same Domain Configuration section:

1. In the Backend URL field, enter the full URL of your API CNAME:

   https://api.yourdomain.com

2. Click Save to generate your verification token

Step 6: Insert TXT Record for Domain Verification

After saving, the platform generates a unique TXT verification token for your domain.

1. Copy the generated token shown on the settings page — it will look like:

   nestsms-verify=abc123xyzxxxxxxxxxxxxxxxx

2. Go back to your DNS provider and add a TXT record:

Step 7: Wait for Verification

After adding the TXT record, the platform will automatically check for it every few minutes.

DNS propagation can take 15 minutes to 48 hours depending on your provider.

The status badge on the Organizations settings page will update:

• Pending - verification not yet confirmed
• Verified - domain ownership confirmed

Step 8: Visit Your Custom Domain

Once your domain shows Verified, open a browser and navigate to your frontend URL:

https://app.yourdomain.com

The platform should load with your organization's branding applied.

Step 9: Upload Favicon & Brand Logo

Favicon

• Recommended size: 32×32 px or 64×64 px
• Accepted formats: .ico, .png
• Appears in: Browser tab

Brand Logo

• Recommended format: SVG or PNG (transparent background)
• Max file size: 500 KB
• Displayed in: Top navigation bar of your white-labeled portal
• Recommended dimensions: height 40px, width proportional

Step 10: You're Live! 🎉

Your white-label platform is fully set up. Here's a summary of what you've configured:

Your clients can now access the platform through your custom domain with your full branding applied.

Troubleshooting

Need Help?

Contact support at support@nestsms.com or open a ticket from your dashboard.

Next Steps

• Generate API keys
• View API Reference
• Learn about bulk SMS file formats
• Integrate with frameworks