Skip to content

Namecheap Setup Guide

Connect your Namecheap account to import and track domains using the Namecheap XML API.

IP whitelisting required

Namecheap requires your server IP to be manually whitelisted before API calls succeed. This approval process can take up to 48 hours. Plan accordingly before connecting.

Before you start

Approval time
Manual IP review — allow up to 48 hours after submitting the whitelist request
API eligibility
20+ domains, $50 account balance, $50 spent in the last 2 years, or manual approval
IP whitelisting
Required
Token expiry
Never
Setup difficulty
Medium

Credential fields

Domainion will ask for these fields when you connect your Namecheap account.

Field Description
Username Your Namecheap account username
API Key From Profile → Tools → API Access
Client IP Must be whitelisted in your Namecheap API settings

How to generate credentials in Namecheap

  1. 1 Sign in to Namecheap and go to Profile > Tools > API Access.
  2. 2 Enable API access if it is not already enabled.
  3. 3 Note your Username — this is your Namecheap account username, not your email address.
  4. 4 Copy your API Key.
  5. 5 Under Whitelisted IPs, add the IP address that Domainion will use to make API calls. If you are unsure of your server IP, contact your hosting provider.
  6. 6 Submit the whitelist request. Approval can take up to 48 hours.

Open Namecheap API settings →

How to connect credentials in Domainion

  1. 1 Sign in to Domainion and go to Registrars in the left sidebar.
  2. 2 Find the Namecheap card and click Configure.
  3. 3 Fill in the credential fields and click Save Credentials.
  4. 4 Click Sync Domains to import your domains immediately, or wait for the next automatic daily sync.

Sync behaviour

Domainion syncs your domain list from Namecheap once per day automatically. You can also trigger a manual sync at any time from the Registrars page.

Each sync imports your domain names, expiry dates, and auto-renew status.

Auto-renew: Domainion reads your auto-renew status from Namecheap but cannot change it via the API. To change auto-renew settings, log in to your Namecheap account directly.

Troubleshooting

API call returns an IP not whitelisted error
Verify the IP you entered in Namecheap matches the Client IP you entered in Domainion exactly. Allow up to 48 hours after adding a new IP before trying again.
Sync completes but no domains appear
Confirm your API key is active and that the Namecheap account linked to these credentials has domains registered under it.
Auto-renew changes made in Domainion do not take effect
Namecheap does not support auto-renew updates via its API. Change auto-renew settings directly in your Namecheap account dashboard.

References

Last verified: 2026-05-20

Confirm deletion