On this page
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 Sign in to Namecheap and go to Profile > Tools > API Access.
- 2 Enable API access if it is not already enabled.
- 3 Note your Username — this is your Namecheap account username, not your email address.
- 4 Copy your API Key.
- 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 Submit the whitelist request. Approval can take up to 48 hours.
How to connect credentials in Domainion
- 1 Sign in to Domainion and go to Registrars in the left sidebar.
- 2 Find the Namecheap card and click Configure.
- 3 Fill in the credential fields and click Save Credentials.
- 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