DomainsDocsSign in
Guides

Free subdomains

No domain yet? Claim a name like yourteam.itoka.dev. It's live on ns1 and ns2 the moment you claim it.

A free subdomain is an ordinary Itoka zone: records, presets, propagation checks, webhooks, managers and API keys all work the same way. There's no verification and no registrar, because Itoka owns itoka.dev. Each account can have up to three, and they stay yours after the hackathon.

# Is it available?
curl "https://api.itoka.ng/api/v1/free-subdomains/check?name=yourteam" -H "Authorization: Bearer $ITOKA_API_KEY"
# {"name": "yourteam.itoka.dev", "available": true, "reason": ""}

# Claim it
curl https://api.itoka.ng/api/v1/free-subdomains -H "Authorization: Bearer $ITOKA_API_KEY" \
  -H "Content-Type: application/json" -d '{"name": "yourteam"}'

Claiming needs zones:manage on a key for all zones. In the dashboard: Add a zone → Get a free subdomain.

Names

  • 3 to 30 letters, digits and hyphens, one label: yourteam, not a.yourteam. Add records like www inside it instead.
  • Reserved names can't be claimed: www, api, app, mail, login, admin, status, support and similar.
  • Names containing brands people impersonate (banks, payment apps, big tech) aren't available.
  • The check endpoint answers 200 with available and, when it's not, a reason (or 503 when free subdomains are off on the server).

Errors

StatusCodeMeans
403email_unverifiedConfirm your email first (for a key, its creator’s email).
422invalid_subdomainThe name breaks a rule above; the message says which.
409zone_existsSomeone has it already.
409too_many_subdomainsYour account has three.
503free_subdomains_offNot available on this server right now.

A claimed subdomain is an ordinary zone with kind: "free_subdomain" (other zones are "domain"). It comes back live at once: there's no delegation to wait for.

Suspension

A free subdomain used for phishing, impersonation, malware or spam is suspended: its records are removed at once and changes are refused. The zone shows status: "error" with the reason in status_note, and writes answer 409 suspended. If you think it's a mistake, email hello@itoka.ng.

PreviousDNS records