Namecheap icon

Namecheap

Consume Namecheap API
Join our community

Actions28

Overview

The node integrates with the Namecheap API to manage DNS records for domains. Specifically, the "Set Custom" operation under the "DNS Record" resource allows users to configure custom nameservers for a given domain. This is useful when you want to delegate DNS management to external or third-party nameservers rather than using default ones provided by the registrar.

Common scenarios include:

  • Pointing a domain to custom DNS hosting services.
  • Migrating DNS management from one provider to another.
  • Setting up advanced DNS configurations that require specific nameservers.

Example: You have purchased example.com and want to use your own DNS servers ns1.exampledns.com and ns2.exampledns.com. Using this node, you can set those nameservers directly via the Namecheap API.

Properties

Name Meaning
Domain Name The domain for which you want to manage DNS records (e.g., example.com).
Nameservers A comma-separated list of custom nameservers to assign to the domain (e.g., ns1.example.com,ns2.example.com).

Output

The node outputs a JSON object with the following structure:

{
  "success": true,
  "data": { /* response data from the API call */ }
}
  • success: Boolean indicating whether the operation was successful.
  • data: Contains the response returned by the Namecheap API after setting the custom nameservers. The exact structure depends on the API response but generally confirms the update status.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Namecheap API.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • The node depends on the internal Namecheap API client classes bundled within the node implementation.

Troubleshooting

  • Invalid Domain Name: If the domain name is incorrect or not registered under your account, the API will fail. Verify the domain spelling and ownership.
  • Invalid Nameservers Format: Ensure nameservers are provided as a comma-separated string without extra spaces or invalid characters.
  • API Authentication Errors: If the API key or token is missing or invalid, the node will throw an authentication error. Check your credential configuration.
  • Operation Not Supported: If the operation or resource parameters are misconfigured, the node throws errors indicating unknown operations or resources.
  • Network Issues: Connectivity problems may cause timeouts or failures. Ensure network access to the Namecheap API endpoints.

Links and References

Discussion