SDKs & Libraries

Official SDKs

Python SDK

Modern Python client with async/await, Pydantic models, and full type hints.

View on GitHub

Node.js SDK

TypeScript SDK with full type support, async/await, and comprehensive error handling.

View on GitHub

PHP SDK

Object-oriented PHP SDK with Guzzle HTTP client and rich data models.

View on GitHub

Go SDK

Idiomatic Go SDK with comprehensive coverage for domains, credentials, messages, and more.

View on GitHub

Installation

# Python
pip install kirimemail-smtp-sdk

# Node.js
npm install @kirimemail/smtp-sdk

# PHP
composer require kirimemail/smtp-sdk

# Go
go get github.com/kirimemail/kirimemail-smtp-go-sdk

Quick Start

Python

import asyncio
from kirimemail_smtp import SmtpClient, MessagesApi

async def send_email():
    client = SmtpClient(username="your-username", token="your-token")
    messages_api = MessagesApi(client)

    result = await messages_api.send_message(
        domain="example.com",
        message={
            "from": "[email protected]",
            "from_name": "Company Name",
            "to": "[email protected]",
            "subject": "Hello from Python SDK",
            "text": "This is a test email sent using the Kirim.Email Python SDK."
        }
    )

    print(f"Email sent: {result}")

asyncio.run(send_email())

Node.js

const { SmtpClient, MessagesApi } = require('@kirimemail/smtp-sdk');

async function sendEmail() {
  const client = new SmtpClient('your-username', 'your-token');
  const messagesApi = new MessagesApi(client);

  const result = await messagesApi.sendMessage('example.com', {
    from: '[email protected]',
    to: '[email protected]',
    subject: 'Hello from Node.js SDK',
    text: 'This is a test email sent using the KirimEmail Node.js SDK'
  });

  console.log('Email sent:', result);
}

sendEmail();

PHP

<?php
require_once 'vendor/autoload.php';

use KirimEmail\Smtp\Client\SmtpClient;
use KirimEmail\Smtp\Api\MessagesApi;

$client = new SmtpClient('your_username', 'your_token');
$messagesApi = new MessagesApi($client);

$result = $messagesApi->sendMessage('example.com', [
    'from' => '[email protected]',
    'to' => '[email protected]',
    'subject' => 'Hello from PHP SDK',
    'text' => 'This is a test email sent using the PHP SDK.'
]);

if ($result['success']) {
    echo "Email sent successfully!\n";
}
?>

Go

package main

import (
    "fmt"
    "log"

    smtpsdk "github.com/kirimemail/kirimemail-smtp-go-sdk"
)

func main() {
    client := smtpsdk.NewClient("your-username", "your-api-token")

    response, err := client.Messages().Send("example.com", smtpsdk.MessageSendRequest{
        From:    "[email protected]",
        FromName: "Company Name",
        To:      []string{"[email protected]"},
        Subject: "Hello from Go SDK",
        Text:    "This is a test email sent using the Kirim.Email Go SDK.",
    }, nil)

    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Email sent: %v\n", response.Success)
}

Features Overview

Feature	Python	Node.js	PHP	Go
Domain Management	✓	✓	✓	✓
Credential Management	✓	✓	✓	✓
Send Emails	✓	✓	✓	✓
Attachments	✓	✓	✓	✓
Templates	✓	✓	✓	✓
Email Validation	✓	✓	✓	✓
Logs	✓	✓	✓	✓
Suppressions	✓	✓	✓	✓
Webhooks	✓	✓	✓	✓
User Quota	✓	✓	✓	✓