smtp-management

Kirim.Email SMTP management node for n8n - validate emails, check quota, and send emails

Documentation

@kirimemail/n8n-nodes-smtp-management

n8n community node for Kirim.Email SMTP API - validate emails, check quota, send transactional emails, and view email logs.

n8n is a fair-code licensed workflow automation platform.

Installation
Nodes
Credentials
Compatibility
Error Handling
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Nodes

KirimEmail Message

Send transactional emails using Kirim.Email SMTP.

Operations:

  • Send - Send a single transactional email
  • Send with Template - Send email using a saved template

Fields:

  • Domain - Your verified Kirim.Email domain
  • From - Sender email address
  • From Name - Optional sender display name
  • To - Recipient email address(es) - supports single email, comma-separated emails, or JSON array (max 1000 recipients)
  • Subject - Email subject line
  • Text Body - Plain text content
  • HTML Body - Optional HTML content
  • Reply To - Optional reply-to address
  • Headers (JSON) - Optional custom headers
  • Attachments - Optional binary attachments

KirimEmail Validation

Validate email addresses individually or in bulk.

Operations:

  • Validate - Validate a single email address
  • Validate Strict - Validate with strict mode (no warnings)
  • Validate Bulk - Validate multiple emails (max 100)
  • Validate Bulk Strict - Validate multiple emails with strict mode

Fields:

  • Email / Emails - Email address(es) to validate
  • Simplify Output - Return simplified output with essential fields only

KirimEmail Quota

Check quota information.

Operations:

  • Get - Get current quota information

KirimEmail Log

Get email logs for your domain.

Fields:

  • Domain - Your verified Kirim.Email domain
  • Start Date - Filter logs by start date (ISO8601)
  • End Date - Filter logs by end date (ISO8601)
  • Sender - Filter logs by sender email
  • Recipient - Filter logs by recipient email
  • Subject - Filter logs by subject (partial match)
  • Event Type - Filter logs by event type (bounced, clicked, deferred, delivered, failed, opened, permanent_fail, queued, send, temporary_fail, unsubscribed)
  • Tags - Filter logs by tags (partial match)
  • Limit - Max number of results to return (default: 50, max: 10000)
  • Offset - Offset for pagination

KirimEmail SMTP Webhook Trigger

Receive webhook events from Kirim.Email SMTP.

Events:

  • Email queued, sent, delivered, bounced, etc.
  • Automatic signature verification

Fields:

  • Simplify Output - Return a simplified output with essential fields only

Credentials

KirimEmail SMTP User API

  1. Log in to your Kirim.Email account
  2. Navigate to your SMTP settings
  3. Copy your API token
  4. Use the API token as the password in n8n credential (username is api)

KirimEmail SMTP Webhook API

Required for the KirimEmail SMTP Webhook Trigger node.

  1. Log in to your Kirim.Email account
  2. Navigate to your domain settings
  3. Copy your API key and API secret
  4. Enter your verified domain name

Compatibility

Compatible with n8n@1.60.0 or later

Error Handling

All nodes include comprehensive error handling for API responses:

  • 400 Bad Request - Invalid request parameters
  • 401 Unauthorized - Invalid or missing authentication credentials
  • 403 Forbidden - You do not have permission to access this resource
  • 404 Not Found - The requested resource was not found
  • 422 Validation Error - Invalid input data
  • 429 Rate Limit Exceeded - Too many requests. n8n will automatically retry with built-in retry mechanism
  • 500 Server Error - Internal server error

For 429 errors, n8n's built-in retry mechanism will automatically retry the request.

Resources

Discussion