🌐 Custom Domain
Use your own domain for the webhook portal. White-label your customers' experience.
Overview
Custom domains let you use your own domain (e.g., webhooks.yourcompany.com) instead of the default HookSniff URL. This gives your customers a branded, professional experience.
How it works: You point your domain to HookSniff via DNS. We verify ownership and automatically provision an SSL certificate. Your customers access the portal through your domain.
Step-by-Step Guide
1Add your domain
Go to Dashboard → Custom Domain and enter the domain you want to use.
- Use a subdomain like
webhooks.yourcompany.com - You can paste the full URL (
https://webhooks.yourcompany.com) — we'll strip the protocol automatically - Only use domains you own and control
After adding, you'll see two DNS records you need to configure.
2Add DNS records
Log in to your domain provider and add the two records shown in the dashboard:
| Type | Name | Value | Purpose |
|---|---|---|---|
CNAME | webhooks.yourcompany.com | cname.vercel-dns.com | Points your domain to HookSniff |
TXT | _hooksniff.webhooks.yourcompany.com | hooksniff-verify=... | Proves you own the domain |
Where to add these:
- Cloudflare: DNS → Records → Add record
- GoDaddy: DNS Management → Add
- Namecheap: Advanced DNS → Add New Record
- AWS Route 53: Hosted zones → Create record
- Google Domains: DNS → Custom resource records
⏱ Important: DNS changes take 5–30 minutes to propagate globally. Don't worry if verification fails immediately — just wait and try again.
3Verify & go live
After adding the DNS records and waiting a few minutes, click "Verify Domain" in the dashboard.
- ✅ Success: Your domain is verified and SSL certificate is automatically provisioned
- ❌ Failed: DNS records not found yet — wait a few more minutes and try again
Once verified, your customers can access the webhook portal through your custom domain with a valid HTTPS certificate.
Common Issues
"DNS records not found"
This is normal if you just added the records. DNS propagation takes 5–30 minutes. Wait and try again. If it still fails after 30 minutes, double-check that the record names and values match exactly what's shown in the dashboard.
SSL certificate not working
SSL provisioning happens automatically after verification and can take up to 15 minutes. If HTTPS still doesn't work after that, try removing and re-adding the domain.
"Cannot use this domain"
Some domains are reserved (e.g., hooksniff.com, localhost). Use a domain you own.
"Domain already registered"
This domain is already in use by another account. Each domain can only be registered once.
API Reference
You can also manage custom domains via the API:
# List domains
GET /v1/custom-domains
# Add a domain
POST /v1/custom-domains
{ "domain": "webhooks.yourcompany.com" }
# Verify a domain
POST /v1/custom-domains/:id/verify
# Delete a domain
DELETE /v1/custom-domains/:idAvailability
| Plan | Custom Domains | SSL |
|---|---|---|
| Developer | ❌ | — |
| Startup | ✅ | Auto |
| Pro | ✅ | Auto |
| Enterprise | ✅ Unlimited | Auto |