Skip to main content
Tidy Names

Connecting a Registrar

Registrar connections let Tidy Names automatically import and sync all domains from your registrar account. This is the recommended way to manage your portfolio.

How It Works

Each registrar connection uses a read-only API token to securely access your domain data. Tidy Names never modifies your domains - it only reads information like domain names, expiry dates, DNS records, and nameservers.

When you add a connection, Tidy Names will:

  1. Verify the API token is valid
  2. Import all domains from the account
  3. Fetch DNS records for each domain
  4. Periodically sync to pick up any changes

Supported Registrars

RegistrarStatusGuide
CloudflareAvailableSetup guide
GoDaddyAvailableSetup guide
NamecheapAvailable*Setup guide
PorkbunAvailableSetup guide
Name.comComing soon-

*Namecheap only issues API credentials to accounts that meet its own criteria: a $50+ account balance, 20+ domains, or $50+ of purchases in the last 2 years. If your account does not qualify, you can still track Namecheap domains by importing a CSV or adding them manually. See the Namecheap guide for details.

Adding a Connection

  1. Navigate to Connections in the sidebar
  2. Click Add Connection
  3. Select your registrar from the list
  4. Follow the registrar-specific guide to generate an API token with the correct permissions
  5. Paste the token into the credential field
  6. Optionally give the connection a display name (e.g. "Production Cloudflare")
  7. Click Test Connection to verify it works
  8. Click Save Connection to start importing domains

Security

API credentials are encrypted at rest using AES-256-GCM before being stored. We recommend using API tokens with the minimum required permissions - typically read-only access to zones and DNS records.

You can revoke a connection at any time from the Connections page. This removes the encrypted credentials, stops syncing, and deletes the domains imported through that connection. To replace an expiring credential without losing that data, use Update Credentials instead.

Managing Connections

The Connections page shows all active registrar connections with their sync status, domain count, and last sync time. You can:

  • Sync Now to pull the latest domain data on demand
  • Update Credentials to swap in a fresh token without losing your synced domains, tags or history - necessary for registrars whose credentials expire, such as GoDaddy
  • Remove a connection to stop syncing and delete stored credentials
  • View the number of domains imported from each connection
  • See when the last sync occurred and whether any errors arose

When a registrar rejects the stored credentials - most often because a token expired or was revoked - the connection is marked Reconnect required and automatic syncing pauses until you supply a working credential. Your imported domain data is left untouched.

Next Steps