Namecheap icon

Namecheap

Consume Namecheap API

Overview

The node integrates with the Namecheap API to manage domain-related operations. Specifically, the "Set Contacts" operation under the "Domain" resource allows users to update contact information for a specified domain name. This is useful when you need to change administrative, registrant, technical, or billing contact details associated with a domain.

Common scenarios include:

  • Updating the registrant's contact details after a company rebranding.
  • Changing the technical contact when switching IT service providers.
  • Correcting or updating phone numbers or email addresses linked to domain contacts.

Practical example: You have purchased a domain and want to set or update the registrant's contact information to ensure that all domain-related notifications are sent to the correct person.

Properties

Name Meaning
Domain Name The domain name on which to operate (e.g., example.com).
Contact Type The type of contact to set. Options: Admin, Registrant, Tech, AuxBilling.
Contact Information Collection of contact details including:
- First Name: Contact's first name.
- Last Name: Contact's last name (required).
- Organization: Name of the organization.
- Job Title: Contact's job title.
- Address 1: Primary address line (required).
- Address 2: Secondary address line.
- City: City name (required).
- State/Province: State or province (required).
- Postal Code: Postal or ZIP code (required).
- Country: Two-letter country code (e.g., US) (required).
- Phone: Phone number in format +NNN.NNNNNNNNNN (required).
- Email: Email address (required).

Output

The node outputs a JSON object for each input item with the following structure:

{
  "success": true,
  "data": { /* response data from the API for the setContacts operation */ }
}
  • success: Boolean indicating if the operation was successful.
  • data: Contains the response returned by the Namecheap API after setting the contact information.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Namecheap API.
  • Requires an API key credential configured in n8n for authentication.
  • Network access to Namecheap's API endpoints must be available.

Troubleshooting

  • Common issues:

    • Missing required fields in contact information (e.g., Last Name, Address1, City, etc.) will cause errors.
    • Invalid domain names or domains not registered under the authenticated account may result in failures.
    • Incorrect phone number or email formats can lead to validation errors from the API.
  • Error messages:

    • "The operation "setContacts" is not known for resource "domain"!": Indicates a misconfiguration or typo in the operation parameter.
    • API errors related to authentication failure suggest checking the API key credential.
    • Validation errors from the API typically indicate missing or malformed contact details; verify all required fields are correctly filled.
  • To resolve errors, ensure all required properties are provided and formatted correctly, and verify API credentials and network connectivity.

Links and References

Discussion