Developer Resources

Build Amazing Integrations

Powerful APIs and SDKs for every platform

Integrate Kalagh into your applications with our comprehensive REST API, gRPC, and ready-to-use SDKs for .NET Core, Python, and Node.js.

🚀

REST API

OpenAPI 3.0 compliant with Swagger docs

⚡

gRPC

High-performance binary protocol

📦

SDKs

Ready-to-use libraries for popular languages

📚

Documentation

Comprehensive guides and examples

View Documentation View Examples View on GitHub

api.kalagh.chat

Kalagh API

REST & gRPC endpoints

API Integration

Connect to Kalagh's powerful APIs

Choose Your Integration Method

Whether you prefer REST APIs, gRPC, or ready-to-use SDKs, we have the perfect solution for your development needs.

REST API

HTTP-based API with JSON

Our REST API is built on OpenAPI 3.0 standards with comprehensive Swagger documentation. Perfect for web applications, mobile apps, and any HTTP-capable client.

OpenAPI 3.0 compliant

Interactive Swagger documentation

JSON request/response format

Real-time webhook support

Explore REST API

gRPC

High-performance binary protocol

Built on HTTP/2 with Protocol Buffers, our gRPC API offers superior performance for high-throughput applications and microservices architectures.

Protocol Buffers serialization

Bidirectional streaming support

Binary format for efficiency

Multi-language client generation

Explore gRPC

API Comparison

Feature	REST API	gRPC
Protocol	HTTP/1.1, HTTP/2	HTTP/2
Data Format	JSON	Protocol Buffers
Performance	Good	Excellent
Streaming	Limited	Full Support
Browser Support	Yes	No

Ready-to-Use SDKs

Get started quickly with our official SDKs for the most popular programming languages and frameworks.

.NET Core SDK

C# and .NET integration

Async/await support

Dependency injection ready

Built-in logging

Configuration binding

Install Package View Source

Python SDK

Python 3.7+ support

AsyncIO support

Full type hints

Pydantic models

Modern HTTP client

Install Package View Source

Node.js SDK

JavaScript/TypeScript support

Promise-based API

TypeScript definitions

Axios HTTP client

Automatic retry logic

Install Package View Source

Quick Installation

.NET Core

dotnet add package Kalagh.SDK

Python

pip install kalagh-sdk

Node.js

npm install @kalagh/sdk

Comprehensive Documentation

Everything you need to integrate with Kalagh, from quick start guides to advanced API references.

Interactive API Explorer

Try our APIs in your browser

Test our APIs directly in your browser with our interactive Swagger UI. No setup required - just enter your API key and start exploring.

Try it out functionality

Request/response schemas

Built-in authentication

Code examples

Open API Explorer

API Reference

Complete endpoint documentation

Detailed documentation for every endpoint, including request/response examples, error codes, and rate limiting information.

All API endpoints

Data models and schemas

Error handling guide

API version history

View API Reference

API Endpoints Overview

Messages

Send and receive messages across all channels

Contacts

Manage customer contact information

Analytics

Track performance and engagement metrics

Webhooks

Real-time event notifications

Code Examples

Get started quickly with these code examples for popular programming languages and frameworks.

.NET Core

C# integration example

// Install the SDK
dotnet add package Kalagh.SDK

// Configure the client
var client = new KalaghClient(new KalaghOptions
{
    ApiKey = "your-api-key",
    BaseUrl = "https://api.kalagh.chat"
});

// Send a message
var message = await client.Messages.SendAsync(new SendMessageRequest
{
    Channel = "whatsapp",
    To = "+1234567890",
    Text = "Hello from Kalagh!",
    Metadata = new Dictionary<string, object>
    {
        ["source"] = "my-app"
    }
});

Console.WriteLine($"Message sent: {message.Id}");

Python

Python integration example

# Install the SDK
pip install kalagh-sdk

# Configure the client
from kalagh import KalaghClient

client = KalaghClient(
    api_key="your-api-key",
    base_url="https://api.kalagh.chat"
)

# Send a message
message = await client.messages.send(
    channel="whatsapp",
    to="+1234567890",
    text="Hello from Kalagh!",
    metadata={"source": "my-app"}
)

print(f"Message sent: {message.id}")

Node.js

JavaScript/TypeScript example

// Install the SDK
npm install @kalagh/sdk

// Configure the client
const { KalaghClient } = require('@kalagh/sdk');

const client = new KalaghClient({
  apiKey: 'your-api-key',
  baseUrl: 'https://api.kalagh.chat'
});

// Send a message
const message = await client.messages.send({
  channel: 'whatsapp',
  to: '+1234567890',
  text: 'Hello from Kalagh!',
  metadata: { source: 'my-app' }
});

console.log(`Message sent: ${message.id}`);

REST API

cURL example

// Send a message via REST API
curl -X POST https://api.kalagh.chat/v1/messages \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "to": "+1234567890",
    "text": "Hello from Kalagh!",
    "metadata": {
      "source": "my-app"
    }
  }'

// Response
{
  "id": "msg_123456789",
  "status": "sent",
  "timestamp": "2024-01-15T10:30:00Z"
}