Step 1: Get Your API Token

• Create a Name.com account
• Go to Account Settings → Security → API Tokens
• Issue both development and production tokens

You’ll use these tokens to authenticate all your API requests.

✅ Tip: Keep your API token secure — treat it like a password.

🔒 Note: If your account has two-factor authentication (2FA) enabled, go to Account Settings → Security, and toggle Name.com API Access on at the bottom.

Step 2: Choose Your Environment

Name.com offers two separate environments:

Sandbox Notes:

• Use your username with -test appended (e.g., reseller123-test)
• The sandbox is API-only — not accessible through the browser
• Requires a separate sandbox API token
• Supports the Try It feature (limited to test environment)
• Includes preloaded testing credit
• Data does not sync with production
• Test domains must be registered in sandbox before use

Step 3: Authenticate Your API Requests

Use HTTP Basic Auth with your username and API token.

curl -u your-username:your-api-token https://api.dev.name.com/core/v1/hello

For Sandbox, use your -test username and sandbox token. You can find this in the Name.com Web UI under Account Settings → Security → API Tokens

Step 4: Make Your First API Call

Call the GET /core/v1/hello endpoint to verify connectivity:

curl -u your-username:your-api-token https://api.dev.name.com/core/v1/hello

A Successful Response should look like this:

{
"server": "name.com api server",
"server_time": "2025-04-28T15:30:00Z",
"message": "hello world"
}

If you see this message — your authentication was successful!

Troubleshooting Common Issues

Next Steps

• Explore API Resources
• Read the Full API Overview
• Visit the FAQ and Troubleshooting Guide