Guides / API tokens
How to create a Namecheap API token with the narrowest permissions
Shipyard uses a Namecheap token for domain registrar. The token is stored in your computer's keychain and is not sent to shipyardmcp.com. These are the exact steps, and the smallest set of permissions that works.
Create the token
Start here: https://ap.www.namecheap.com/settings/tools/apiaccess/
- Open the link and switch API Access on.
- Under Whitelisted IPs add the public IPv4 address of the machine that runs Shipyard.
- Copy the API key and paste it into Shipyard with your username and that IP.
Permissions, and why each one is needed
- API access (account-wide): Namecheap has a single API key per account with no finer scopes.
Set up once in Namecheap before your first launch
- Namecheap only enables the API for accounts with at least 20 domains, or $50 balance, or $50 spent in the last two years. Top up if you have none of these. (https://ap.www.namecheap.com/profile/billing/topup)
- API purchases are paid from account balance: top up enough to cover the domain. (https://ap.www.namecheap.com/profile/billing/topup)
- Set a default address. It is used as the registrant contact. (https://ap.www.namecheap.com/profile/addresses)
What stays manual
These are things only a person can do at this provider. Shipyard cannot and will not do them for you.
- Namecheap only enables the API for accounts with at least 20 domains, or $50 balance, or $50 spent in the last two years.
What you paste into Shipyard
- Namecheap username
- API key
- Your public IPv4 address (must be whitelisted): Find it with: curl -4 ifconfig.me
Have this set up for you
Shipyard connects your accounts once and then does all of this for every new product, in about an hour.
See how it works