Custom Domains Guide - Snip API Documentation

Custom domains are available on Pro and Enterprise plans.

Why Use Custom Domains?

Brand Recognition: Use your own domain (e.g., go.yourbrand.com)
Trust: Users trust links from your domain
Consistency: Match your brand identity
Professional: Look more professional in marketing materials

Step 1: Add Your Domain

First, add your domain through the API:

const response = await axios.post('https://snip.sa/api/domains', {
  domain: 'yourdomain.com',
  subdomain: 'go'  // Optional: creates go.yourdomain.com
}, {
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  }
});

const dnsRecords = response.data.data.domain.dnsRecords;
console.log('Add these DNS records:', dnsRecords);

Step 2: Configure DNS

Add the provided DNS records to your domain registrar:

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

Add CNAME Record

Create a new CNAME record:

Type: CNAME
Name: go (or your subdomain)
Value: snip.sa
TTL: 3600 (or default)

Save Changes

Save the DNS record and wait for propagation (can take up to 48 hours)

Example DNS Configuration

Type	Name	Value	TTL
CNAME	go	snip.sa	3600

Step 3: Verify Your Domain

After DNS propagation, verify your domain:

const response = await axios.post(
  'https://snip.sa/api/domains/507f1f77bcf86cd799439015/verify',
  {},
  {
    headers: {
      'X-API-Key': 'your_api_key_here'
    }
  }
);

if (response.data.data.domain.verified) {
  console.log('✅ Domain verified successfully!');
}

DNS propagation typically takes 15-30 minutes but can take up to 48 hours.

Step 4: Use Your Custom Domain

Once verified, create URLs with your custom domain:

const response = await axios.post('https://snip.sa/api/urls', {
  originalUrl: 'https://example.com/product',
  domainId: '507f1f77bcf86cd799439015',  // Your domain ID
  customCode: 'spring-sale'
}, {
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  }
});

// Result: https://go.yourdomain.com/spring-sale

Troubleshooting

Domain verification fails

Check DNS records are correct
Wait longer for DNS propagation
Clear your DNS cache: ipconfig /flushdns (Windows) or sudo dscacheutil -flushcache (Mac)
Use DNS Checker to verify propagation

SSL certificate issues

SSL certificates are automatically provisioned. If you see SSL errors:

Wait 24 hours after verification
Contact support if issues persist

CNAME conflicts

If you have existing records on the subdomain:

Choose a different subdomain
Remove conflicting records
Use root domain (requires A record instead)

Best Practices

Use a subdomain (go, link, s) instead of root domain

Keep subdomain short and memorable

Test domain after verification

Update marketing materials with new domain

Managing Multiple Domains

You can add multiple custom domains:

// Add multiple domains
await addDomain('go.brand1.com');
await addDomain('link.brand2.com');
await addDomain('s.brand3.com');

// List all domains
const domains = await axios.get('https://snip.sa/api/domains', {
  headers: { 'X-API-Key': 'your_api_key_here' }
});

Need Help?

Contact Support

Our team can help with custom domain setup

​Why Use Custom Domains?

​Step 1: Add Your Domain

​Step 2: Configure DNS

​Example DNS Configuration

​Step 3: Verify Your Domain

​Step 4: Use Your Custom Domain

​Troubleshooting

​Best Practices

​Managing Multiple Domains

​Need Help?

Contact Support

Why Use Custom Domains?

Step 1: Add Your Domain

Step 2: Configure DNS

Example DNS Configuration

Step 3: Verify Your Domain

Step 4: Use Your Custom Domain

Troubleshooting

Best Practices

Managing Multiple Domains

Need Help?