Rate Limits & Overage
| Tier | Included Clicks | Overage Rate | API Calls/mo |
|---|---|---|---|
| Free | 1,000 | — | — |
| Pro | 50,000 | $0.15 / 1K clicks | 1,000 |
| Builder | 500,000 | $0.15 / 1K clicks | 10,000 |
| Enterprise | Unlimited | — | Custom · Contact us |
Custom Domains
Pro+ add-onBrand your short links with your own domain (e.g. go.yourbrand.com). Custom domains are a paid add-on available to Pro and Builder subscribers. Enterprise plans include unlimited domains at no extra cost.
| Plan | Add-on price | Domains |
|---|---|---|
| Free | Not available | — |
| Pro | $9.99 / domain / mo | Up to 99 |
| Builder | $7.99 / domain / mo | Up to 99 |
| Enterprise | Included | Unlimited |
Setup Guide
-
1
Add your domain
POST
/api/user/domainswith your hostname. You'll receive a unique TXT verification token. -
2
Add TXT record to your DNS
In your DNS provider, create:
_awsys-verify.yourdomain.com TXT "awsys-verify=<token>" -
3
Add CNAME record
Point your domain at AWSYS:
yourdomain.com CNAME custom.awsys.co -
4
Activate & billing starts
After DNS verification, POST
/api/user/domains/:domain/activate. SSL is provisioned automatically (Let's Encrypt). Billing starts immediately.
DNS verification is checked automatically every 5 minutes. SSL provisioning typically completes within 2 minutes of the first HTTPS request.
API Reference
/api/user/domainsList all your custom domains with status, SSL state, and billing info.
/api/user/domainsRegister a domain. Body: {"domain":"go.example.com"}. Returns TXT verification token.
/api/user/domains/:domain/verifyManually trigger DNS TXT check. Returns verified: true/false.
/api/user/domains/:domain/activateStart billing and SSL provisioning. Domain must be verified first. Enterprise users skip billing.
/api/user/domains/:domainUpdate domain settings. Body: {"setDefault":true} to use as default for new links.
/api/user/domains/:domainRemove domain and cancel Stripe billing item. Links using this domain continue to redirect via awsys.co.
/api/domains/check/:hostnameCheck if a hostname is available for registration. Returns {"available":true/false}.
Common error codes
TIER_UPGRADE_REQUIRED— Custom domains require Pro or higherDOMAIN_TAKEN— Domain already registered by another userRESERVED_DOMAIN— Domain is an AWSYS system domainINVALID_DOMAIN— Hostname format is invalidNOT_VERIFIED— Domain must pass TXT check before activation