Skip to main content

How to get a Namecheap API key

Dennis Postma21 May 2026
Reading time3 minutes
Guides

Enable Namecheap API access, whitelist an IPv4 address and connect the key to DNSense. Includes the eligibility rules.

DNSense guide cover: a Namecheap API key tied to a whitelisted IP address

Namecheap is the strictest provider to set up. The key is easy. The catch is that Namecheap answers only from an IPv4 address you have whitelisted, and your account has to qualify for API access in the first place.

Check eligibility

For production access, Namecheap wants one of these on your account:

  • at least 20 domains,
  • a balance of at least $50, or
  • at least $50 spent in the last two years.

If you meet none of them, Namecheap's sandbox (a separate account at sandbox.namecheap.com) is the only way to test. It will not hold your real domains.

Enable API access

  1. Log in and go to Profile > Tools.
  2. Under Business & Dev Tools, find Namecheap API Access and click Manage.
The Tools page with Namecheap API Access and its Manage button
  1. Switch it on and confirm with your password and the terms.
  2. Copy the API key that appears. Your API username is simply your Namecheap account username.
The API Access page with the switch on, the API key and the whitelisted IPs

Whitelist an IP address

On the same page, click Edit next to Whitelisted IPs, add an IPv4 address and save. Only IPv4 works. A call from any other address fails, typically with error 1011150.

The Whitelisted IPs dialog with the Add IP button

The address has to be the one DNSense connects from, because Namecheap checks it on every call. If you do not know which address that is, ask DNSense support before you save, and do not whitelist your own office address. It will not help.

Connect it to DNSense

Add a connection, choose Namecheap and fill in:

  • Account username
  • API key
  • Whitelisted IP address, the same IPv4 address as on the Namecheap page.

Limits

Namecheap allows 50 calls per minute, 700 per hour and 8000 per day per key, so DNSense checks Namecheap zones for drift less often than other providers. Namecheap also cannot store SRV or TLSA records through this API, and TTLs run from 60 to 60000 seconds.