0-CodeKit

Overview

This node provides a utility to verify and correct email addresses for business-related workflows. It is designed to check the validity of an email address and, if possible, suggest corrections for common mistakes (such as typos in domain names). This can be particularly useful in scenarios where you need to ensure that customer or user email addresses are valid before sending communications, onboarding users, or processing transactions.

Practical examples:

• Validating user-submitted emails during registration or lead capture.
• Cleaning up existing contact lists by verifying and correcting email addresses.
• Preventing failed email deliveries due to invalid or mistyped addresses.

Properties

Output

The output will be a JSON object containing the results of the email verification and correction process. While the exact structure depends on the external service response, typical fields may include:

• email: The original email address submitted.
• isValid: Boolean indicating if the email is valid.
• correction: Suggested correction if the email contains a common mistake (e.g., typo in domain).
• reason or message: Additional information about the validation result.

Example output:

{
  "email": "johndoe@gmial.com",
  "isValid": false,
  "correction": "johndoe@gmail.com",
  "reason": "Common domain typo detected"
}

If the node encounters an error and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

• External Service: Requires access to the CodeKit API endpoint for email validation.
• API Key: You must configure n8n credentials named codeKitApi for authentication.

Troubleshooting

Common issues:

• Invalid or missing API key: If the codeKitApi credential is not set up correctly, requests will fail.
• Malformed email input: If the provided email does not match standard formats, the node may return an error or mark it as invalid.
• Network/API errors: Connectivity issues or downtime of the CodeKit API can cause failures.

Error messages:

• "Missing required parameter: email" – Ensure the "Domain" property is filled with a valid email address.
• "Authentication failed" – Check your codeKitApi credentials in n8n.
• "Request failed with status code XXX" – Indicates an issue with the external API; check the API status or your request parameters.

Links and References

• n8n Documentation: Custom Nodes
• CodeKit API Documentation (if available)
• Email Validation Best Practices