Guides & Tutorials
Custom Domain & SSL Configuration
How to map your own custom branded domains to 1st URL Shortener and VPS instances with automatic SSL.
Custom Domain & SSL Configuration
You can connect your own domain names (e.g. go.yourcompany.com or app.yourcompany.com) to 1st URL Shortener or 1st Cloud VPS with automated Let's Encrypt SSL/TLS certificates.
1. URL Shortener Custom Domain
Step 1: Add Domain in 1st Services
cURL Add Domain
curl -X POST https://api.1st-services.com/v1/shortener/domains \
-H "Authorization: Bearer $FIRST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "go.yourbrand.com"}'
Step 2: Configure DNS Records at your DNS Registrar
Add a CNAME record in Cloudflare, Namecheap, Route53, or your DNS provider:
| Type | Host / Name | Target / Points To | TTL | Proxy Status |
|---|---|---|---|---|
CNAME | go | cname.1st.link | 300 (or Auto) | DNS Only (Gray Cloud) |
Step 3: Verify & Provision SSL
cURL Verify Domain
curl -X POST https://api.1st-services.com/v1/shortener/domains/go.yourbrand.com/verify \
-H "Authorization: Bearer $FIRST_API_KEY"
1st Services will automatically issue an SSL certificate within 60 seconds.
2. VPS Custom Domain (A / AAAA Records)
To point a domain to your VPS:
| Type | Host / Name | Value | Description |
|---|---|---|---|
A | @ (or api) | 194.163.140.22 | Your VPS IPv4 Address |
AAAA | @ (or api) | 2a02:4780:11:100::1 | Your VPS IPv6 Address |