Developer
Unsidra API & SDK
A simple, powerful API for integrating with any platform.
Quick Start
Integration takes 5 minutes.
1
Install the SDK
npm install @unsidra/sdk
2
Add your API key
Dashboard → Settings → API Keys → New Key
3
Integrate
import Unsidra from '@unsidra/sdk'
const uns = new Unsidra({
apiKey: process.env.UNSIDRA_API_KEY,
workspaceId: 'ws_your_workspace_id',
})
// Create / update a customer
await uns.identify('cust_123', {
email: 'ali@example.com',
name: 'Ali Yilmaz',
})
// Send an event
await uns.track('purchase', {
orderId: 'ord_456',
total: 299.90,
currency: 'USD',
items: [{ productId: 'p_1', name: 'T-Shirt', qty: 2 }],
})
// Page view
await uns.page('product_view', {
productId: 'p_1',
category: 'apparel',
})
REST API Reference
Base URL: https://api.unsidra.com
POST
/v1/eventsSend a customer event (purchase, page_view, add_to_cart)
GET
/v1/customersList customers
GET
/v1/customers/:idSingle customer detail and RFM score
GET
/v1/segmentsList segments
POST
/v1/campaignsCreate a campaign
GET
/v1/analytics/overviewSummary analytics metrics
API Features
🔐
API Key Auth
Secure authentication with bearer tokens.
⚡
Rate Limiting
1,000 requests/minute on the Growth plan.
📬
Webhook Support
Register a webhook URL for real-time event notifications.
🌍
REST & GraphQL
REST API, with GraphQL support coming soon.
📊
SDK Libraries
Official SDKs for JavaScript, Python and PHP.
🔄
Idempotency
Idempotency-key support for safe retries.
Start integrating right away
Create a free account to get an API key.
Get a Free API Key