Connect to your host
point_domain (or POST /domains/{domain}/point) sets the records for you. Give it the address your host gave the site.
shell
curl https://plonki.com.au/v1/domains/acmecoffee.com.au/point \
-H "Authorization: Bearer $PLONKI_KEY" -H "Content-Type: application/json" \
-d '{"target": "acmecoffee.vercel.app"}'What gets set
| Target | Root (@) | www | Then, at the host |
|---|---|---|---|
*.vercel.app | A 76.76.21.21 | CNAME to your target | Project, Settings, Domains: add the domain. |
*.netlify.app | A 75.2.60.5 | CNAME to your target | Domain management: add a domain you already own. |
*.onrender.com | A 216.24.57.1 | CNAME to your target | Settings, Custom Domains: add the domain. |
*.github.io | A 185.199.108.153 | CNAME to your target | Repo Settings, Pages, Custom domain. |
*.pages.dev, *.workers.dev | Not set (see below) | CNAME to your target | Pages project, Custom domains: add www. |
*.up.railway.app | Not set | CNAME to your target | Settings, Networking, Custom Domain. |
*.fly.dev | Not set | CNAME to your target | Run fly certs add yourdomain. |
| An IPv4 address | A to the IP | A to the IP | Configure the server for the domain. |
| Any other hostname | Not set | CNAME to your target | Add the domain in your host's dashboard. |
Existing A, AAAA and CNAME records on @ and www are replaced. Send include_www: false to leave www alone.
Root domains and CNAMEs
DNS doesn't allow a CNAME on the root (acmecoffee.com.au itself). For hosts without a fixed IP, either send visitors towww, or move the domain's nameservers to the host (Cloudflare, for example) with set nameservers and manage DNS there.
How long it takes
New records usually work within a few minutes, sometimes up to an hour. Your host issues the HTTPS certificate once it sees the records.