White Label Complete Setup

White Label Complete Setup

1. Understanding White Label Setup

What is White Label?

White Label allows you to rebrand MagicBolt AI as your own product. Your clients will see YOUR company name, YOUR logo, and YOUR domain - not MagicBolt AI.

What You'll Achieve:

  • Your own branded login page (e.g., login.yourcompany.com)

  • Custom Magic Link/QR domain (e.g., link.yourcompany.com)

  • Your company logo throughout the platform

  • Complete control over your agency operations

⏱️ Estimated Setup Time: 2-3 hours

Note: DNS changes can take 16-48 hours to fully propagate worldwide.

2. Before You Start - Important Checklist

Before beginning the setup process, ensure you have access to the following:

✅ Required Items:

Item

What You Need

Domain Name

Access to your domain's DNS settings (GoDaddy, Namecheap, Cloudflare, etc.)

Agency Panel Credentials

Login ID and Password (provided by MagicBolt team)

Company Logo

PNG or JPG format, recommended size: 200x60 pixels

Payment Card

Credit/Debit card for OpenAI and Google Cloud billing

Gmail Account

For creating OpenAI, Google Cloud, and other integrations


🚨 Important: Keep all login credentials in a safe place. You'll need them throughout the setup process.


3. Step 1: Domain & DNS Setup (Required)

⚠️ CRITICAL STEP - Read Carefully

DNS setup is the foundation of your white label. Any mistakes here will prevent your system from working. Take your time and double-check each entry.


You Need to Create 3 CNAME Records:

Record #

Host Name

Purpose

1

login

Customer Login Page (login.yourdomain.com)

2

link

Magic Link/QR Code Domain (link.yourdomain.com)

3

web

Website/Custom Domain (web.yourdomain.com)

Step-by-Step Instructions:

Record 1: Customer Login Domain

Host Name:

login

Record Type:

CNAME

Value/Points To:

6b627031d5ffe764.vercel-dns-016.com

Record 2: Magic Link/QR Domain

Host Name:

link

Record Type:

CNAME

Value/Points To:

6b627031d5ffe764.vercel-dns-016.com

Record 3: Website/Custom Domain

Host Name:

web

Record Type:

CNAME

Value/Points To:

6b627031d5ffe764.vercel-dns-016.com

How to Add DNS Records (General Steps):

  1. Log in to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.)

  2. Find the DNS Management or DNS Settings section

  3. Click 'Add Record' or 'Add New Record'

  4. Select 'CNAME' as the record type

  5. Enter the Host Name (login, link, or web)

  6. Enter the Value: 6b627031d5ffe764.vercel-dns-016.com

  7. Set TTL to 'Automatic' or '3600' (1 hour)

  8. Save the record

  9. Repeat for all 3 records

⏰ Important Timing Information

  • DNS changes can take 16-48 hours to fully propagate worldwide

  • You may see the changes working on your computer within 1-2 hours

  • Don't panic if it doesn't work immediately - this is normal!

  • You can proceed with other setup steps while waiting

4. Step 2: Agency Panel Login & White Label Settings (Required)

Now that your DNS records are set up, it's time to configure your white-label settings in the Agency Admin Panel.

Accessing the Agency Panel

  1. Open your web browser and go to: https://agency.magicbolt.ai/

  2. Enter the Login ID and Password provided by the MagicBolt team

  3. Click 'Sign In'

Configuring White Label Settings

  1. After logging in, click on 'Settings' in the main menu

  2. Navigate to the 'White Label' tab

A. Branding Details

  • Company Logo: Upload your company logo (PNG or JPG, recommended 200x60 pixels)

  • Domain Connection Setup: Upload Your DNS record (Required)

  • Contact Details: Add your company's contact information (optional but recommended)

  • Social Media Links: Add links to your social media profiles (optional)

B. Domain Connection Setup




Field Name

What to Enter

Customer Login URL

login.yourdomain.com (replace 'yourdomain' with YOUR domain)

Magic Link Domain

link.yourdomain.com (replace 'yourdomain' with YOUR domain)

Customer Website URL

yourdomain.com (your main website)

  1. After filling all fields, click 'Save Settings'

C. Support Tab Settings

Navigate to the 'Support' tab and add your support contact information:

  • Support Email Address

  • Support Phone Number (optional)

  • Support Hours (optional)

D. Socials Tab Settings

Navigate to the 'Socials' tab and add your social media profile links:

  • Facebook Page URL

  • Twitter/X Profile URL

  • LinkedIn Company Page URL

  • Instagram Profile URL

5. Step 3: OpenAI API Key Setup (Required)

💡 Why OpenAI?

OpenAI provides the artificial intelligence that generates review responses, creates content, and powers smart features in MagicBolt.

Step-by-Step Instructions:

  1. Go to OpenAI's website: https://platform.openai.com

  2. Click 'Sign Up' if you don't have an account, or 'Log In' if you do

  3. After logging in, you'll see the Dashboard

  4. Click on 'Get Started' (if you're new) or navigate to 'API Keys' in the left menu

  5. Click 'Create New Secret Key' or 'Create API Key'

  6. Give your key a name (e.g., 'MagicBolt Integration')

  7. Click 'Create'

  8. IMPORTANT: Copy the API key immediately - you won't be able to see it again!

  9. Save the API key in a safe place (like a password manager)

Adding Your OpenAI API Key to MagicBolt

  1. Go back to your MagicBolt Agency Panel

  2. Navigate to Settings → Integrations

  3. Find the 'OpenAI API Key' field

  4. Paste your OpenAI API key

  5. Click 'Save'

Setting Up Billing in OpenAI

  1. In your OpenAI Dashboard, click on 'Billing' in the left menu

  2. Click 'Add Payment Method'

  3. Enter your credit/debit card information

  4. Set a monthly budget limit if desired (recommended: $50 to start)

  5. Click 'Save'

6. Step 4: ImageKit Integration (Required)

ImageKit is used to store and manage images in your MagicBolt system. The FREE plan is sufficient for most agencies. You can upgrade later if needed.

Step-by-Step Instructions:

  1. Go to ImageKit's website: https://imagekit.io/registration

  2. Click 'Sign Up' and create an account using your email

  3. Verify your email address (check your inbox for the verification email)

  4. Log in to your ImageKit account

  5. Follow the official documentation to get your API credentials

  6. Documentation link: https://imagekit.io/docs/overview

  7. Copy your Public Key, Private Key, and URL Endpoint

  8. Go to your MagicBolt Agency Panel → Settings → Integrations

  9. Find the ImageKit section and paste your credentials

  10. Click 'Save'

7. Step 5: Kie.ai Integration (Optional)

Kie.ai enables AI-powered image generation in MagicBolt. This feature allows you to create custom images for your clients' social media posts and marketing materials.

Step 1: Create Your Kie.ai Account

  1. Visit: https://kie.ai/

  2. Click 'Get Started'

  3. Complete the sign-up process with your email

  4. Verify your email and log in

Step 2: Navigate to API Keys

  1. After logging in, look for the left sidebar menu

  2. Click on 'API Keys'

  3. You'll be redirected to the API Keys management page

Step 3: Copy Your API Key

  1. Locate your generated API Key on the page

  2. Click the copy icon to securely copy the key

  3. Save it in a safe place

Step 4: Add the API Key to MagicBolt

  1. Open your MagicBolt Agency Panel

  2. Navigate to Settings → Integrations → Kie.ai

  3. Paste your copied API Key into the 'Kie.ai API Key' field

  4. Click 'Save' to complete the integration

8. Step 6: ZeptoMail (Zoho) Email Integration (Optional)

ZeptoMail is required for sending system emails password resets, Plan Allot mail , other.

⚠️ Important: This Step Has Multiple Parts

ZeptoMail setup requires careful attention. Follow each substep carefully. You'll need to verify your domain and create API credentials.

Part 1: Create ZeptoMail Account

  1. Visit: https://zeptomail.zoho.in

  2. Click 'Sign Up' and create an account

  3. Verify your email and log in

Part 2: Create Mail Agent

  1. In ZeptoMail Dashboard, click 'Mail Agents'

  2. Click 'Add Mail Agent'

  3. Enter a name for your Mail Agent (e.g., 'MagicBolt GMB')

  4. Click 'Create'

Part 3: Verify Your Domain

  1. In Mail Agent settings, click 'Verify Domain'

  2. Enter your domain name (e.g., yourdomain.com)

  3. ZeptoMail will provide DNS records (TXT, SPF, DKIM)

  4. Add these records to your domain's DNS settings (similar to Step 1)

  5. Wait for verification (can take up to 48 hours)

  6. Click 'Verify' in ZeptoMail to confirm

Part 4: Set From Name and Email

  • From Name: Your company/brand name (e.g., 'MagicBolt Support')

  • From Email: Email address using your verified domain (e.g., support@yourdomain.com)

Part 5: Get API Key

  1. In ZeptoMail, navigate to 'Settings' → 'API Keys'

  2. Click 'Create New API Key'

  3. Give it a name (e.g., 'MagicBolt Integration')

  4. Copy the generated API Key

  5. Save it securely

Part 6: Generate Auth Code (Zoho API Console)

  1. Go to: https://api-console.zoho.in

  2. Navigate to 'Self Client' → Click 'Create Now'

  3. Copy your Client ID and Client Secret

  4. Click 'Generate Code'

  5. In the Scope field, enter EXACTLY: Zeptomail.MailTemplates.All

  6. Click 'Generate'

⏰ URGENT: The Auth Code expires in 5 minutes! Copy it immediately and add it to MagicBolt Agency Panel.

  1. Copy the generated Auth Code

Part 7: Add Credentials to MagicBolt

  1. Go to MagicBolt Agency Panel → Settings → Integrations → ZeptoMail

  2. Enter your ZeptoMail API Key

  3. Enter your Zoho Client ID

  4. Enter your Zoho Client Secret

  5. Enter the Auth Code (must be done within 5 minutes of generation)

  6. Click 'Save'

9. Step 7: Google Cloud Console API Setup (Required)

Google Cloud Console APIs are required for Google Maps ranking, tracking features, and location-based services. Even if you don't have a Google Cloud account, you can create one easily using your Gmail account.

💡 What You'll Need

  • A Gmail account

  • Credit/Debit card for billing (required by Google, even for free tier)

  • Approximately 15-20 minutes

Part A: Create Google Cloud Account

  1. Go to Google Cloud Console: https://console.cloud.google.com/

  2. Sign in using your Gmail account

  3. If this is your first time, Google will ask you to accept Terms of Service - click 'Agree and Continue'

Part B: Create a New Project

Projects in Google Cloud help you organize your API usage. You'll create one project for MagicBolt.

  1. Look at the top of the page - you'll see 'Select a Project' (near the Google Cloud logo)

  2. Click on 'Select a Project'

  3. In the popup window, click 'NEW PROJECT' (top right corner)

  4. Enter a project name. Example: YourCompanyName-GMB

  5. Leave 'Organization' as 'No organization' (unless you have one)

  6. Click 'CREATE'

  7. Wait a few seconds while Google creates your project

Part C: Setup Billing Account

💳 Why Billing is Required

Google requires a payment method even for free tier usage. This is to prevent abuse.

  1. In Google Cloud Console, click the menu icon (three horizontal lines) in the top left

  2. Scroll down and click 'Billing'

  3. Click 'Link a Billing Account' or 'Add Billing Account'

  4. If you don't have a billing account yet, click 'CREATE BILLING ACCOUNT'

  5. Select your Country and click 'Continue'

  6. Fill in your billing information (name, address)

  7. Enter your credit/debit card details

  8. Accept the terms and click 'START MY FREE TRIAL'

  9. Link this billing account to your project

Part D: Enable Required APIs

You need to enable 4 specific APIs for MagicBolt to work properly. Don't worry - the interface makes this easy!

📋 APIs You Need to Enable:

  1. Distance Matrix API

  2. Geocoding API

  3. Maps JavaScript API

  4. Places API

How to Enable Each API:

  1. In Google Cloud Console, click the menu icon (☰) in the top left

  2. Navigate to 'APIs & Services' → 'Library'

  3. You'll see a search bar at the top - use this to find each API

For Each API (repeat 4 times):

  • Step 1: Type the API name in the search bar (e.g., 'Distance Matrix API')

  • Step 2: Click on the API when it appears in search results

  • Step 3: Click the blue 'ENABLE' button

  • Step 4: Wait a few seconds for it to enable

  • Step 5: Go back to the API Library (click 'Library' in the left menu)

  • Step 6: Search for and enable the next API

💡 Tip: Make sure you enable all 4 APIs. You can verify by going to 'APIs & Services' → 'Enabled APIs & Services' to see your list.

Part E: Create API Key

Now that your APIs are enabled, you need to create an API Key - this is like a password that MagicBolt will use to access Google's services.

  1. In the left menu, go to 'APIs & Services' → 'Credentials'

  2. At the top of the page, click '+ CREATE CREDENTIALS'

  3. From the dropdown menu, select 'API key'

  4. Google will create your API key - a popup will show your key

  5. IMPORTANT: Click 'COPY' to copy your API key immediately

  6. Paste it into a safe place (like Notepad or password manager)

  7. Click 'CLOSE' on the popup

✅ Your API Key Format

Your API key will look something like this:

AIzaSyDXXXXXXXXXXXXXXXXXXXXXXXXXXXX

(It starts with 'AIza' and is about 39 characters long)

Part F: Add API Key to MagicBolt

  1. Go to your MagicBolt Agency Panel

  2. Navigate to Settings → Integrations

  3. Find the 'Google Maps API Key' or 'Google Cloud API Key' field

  4. Paste your copied API key

  5. Click 'Save'

🎉 Google Cloud Console Setup Complete!

Your Google APIs are now connected to MagicBolt.

10. Step 8: Email Template Customisation (Optional)

MagicBolt comes with pre-designed email templates, but you can customize them to match your brand. This step is optional but recommended for a fully branded experience.

📧 Available Templates:

  • Password Reset Template

  • Welcome Email Template

  • Subscription Confirmation Template

  • Feedback Received Template

How to Customize Email Templates:

  1. Go to your MagicBolt Agency Panel

  2. Navigate to Settings → Email Templates

  3. Select the template you want to edit

  4. Click 'Edit Template'

  5. Select 'HTML' mode (if you want to use custom code)

  6. Copy the HTML code from your reference document (provided separately)

  7. Paste it into the HTML editor

  8. Customize the colors, text, and branding as needed

  9. Click 'Save Template'

💡 Template Variables

The templates use variables like {{username}}, {{brand}}, {{support_email}} that automatically get replaced with real data. Don't remove these!

Common Template Variables:

Variable

What It Does

{{username}}

Replaced with the customer's name

{{brand}}

Your company/brand name

{{support_email}}

Your support email address

{{login_url_link}}

Your login page URL

{{new_password}}

Temporary password (for reset emails)

Final Checklist & Next Steps

Before Going Live - Verify Everything:

✓

Item

☐

DNS records added and verified

☐

Company logo uploaded

☐

Login & Magic Link domains working

☐

OpenAI API key added and billing configured

☐

ImageKit connected

☐

Kie.ai API key added

☐

ZeptoMail API key and Auth Code added

☐

Google Cloud Console APIs enabled and API key added

☐

Email templates customized (optional)


🎉 Congratulations!

Your White Label Setup is Complete!

You're now ready to start serving clients under your own brand.

Need Help?

  • Support Email: Contact our support team

  • Documentation: Refer to this guide anytime

  • Share Screenshots: If facing issues, send screenshots to help us assist you faster

Thank you for choosing MagicBolt AI!

— Team MagicBolt.ai


    • Related Articles

    • White Label Setup – Overview Guide

      White Label Setup – Overview Guide This document provides a quick overview of the complete White Label setup process. Each step is explained briefly to help you understand what needs to be done before moving to the detailed setup guid Step 1: Domain ...

    • OpenAI API Key Setup

      This is required for AI-based features. Steps: Login to OpenAI: https://platform.openai.com/ Go to: Settings → API Keys https://platform.openai.com/settings/organization/api-keys Click Create new secret key Copy the generated key (Example): ...

    • Domain & DNS Setup (Very Important)

      You need to point your domains using CNAME records. There are total 4 Records that we have to create 1. Customer Login Domain Host Name : login Record Type: CNAME Value: ghs.googlehosted.com 2. Magic Link / MagicQR Domain Host Name : link Record ...

    • How to Add, Edit, or Update Links in MagicQR /Magic Link

      MagicQR allows you to manage all the links connected to your QR (Google reviews, social media, custom links, etc.). You can easily add new links or update existing ones anytime. Before You Start ✅ Make sure your business is already created (If not, ...

    • How to Set Up MagicQR

      MagicQR helps you collect customer reviews instantly by sharing a smart review link or QR code. Before You Start ✅ Make sure your business is already created (If not, complete the business setup first) Step-by-Step Setup 1. Go to Login Page Log in to ...