{
  "type": "track",
  "event": "Server Started",
  "timestamp": "2023-10-24T12:00:00Z"
}
  
{
  "type": "identify",
  "userId": "usr_99x",
  "traits": {"tier": "enterprise"}
}
POST https://api.yourcdp.com/v1/batch

The Universal Data API.

Bypass ad-blockers and browser restrictions. Send customer traits, behavioral events, and custom catalog data directly from your backend servers with 100% accuracy.

Core Endpoints

Collect any data structure

Our REST API is designed to handle every facet of your business data, from user identities to complex B2B object relationships.

POST /v1/identify

Customer Information

Create or update a user’s profile. Send traits like email, subscription status, or LTV directly from your database.

“userId”: “usr_123”,
“traits”: {
  “email”: “jane@example.com”,
  “plan”: “Enterprise”
}
POST /v1/track

Customer Behavior

Record server-side actions that client-side SDKs might miss, such as recurring billing successes or backend state changes.

“userId”: “usr_123”,
“event”: “Subscription Renewed”,
“properties”: {
  “revenue”: 99.00
}
POST /v1/group

B2B & Custom Objects

Link users to Companies, Workspaces, or sync product catalogs. Perfect for B2B SaaS tracking and account-level analytics.

“userId”: “usr_123”,
“groupId”: “org_555”,
“traits”: {
  “company_name”: “Acme Corp”
}
Developer Experience

Integrate in minutes

Endpoints
  • POST /track
  • POST /identify
  • POST /batch
cURL
Node.js
Python
PHP
curl -X POST https://api.yourcdp.com/v1/track \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Basic {YOUR_API_KEY}' \
  -d '{
  "userId": "user_123",
  "event": "Order Completed",
  "properties": {
    "order_id": "50314",
    "revenue": 29.99
  }
}'
const axios = require('axios');

await axios.post('https://api.yourcdp.com/v1/track', {
  userId: 'user_123',
  event: 'Order Completed',
  properties: { order_id: '50314', revenue: 29.99 }
}, {
  headers: { 'Authorization': 'Basic {YOUR_API_KEY}' }
});
// Select a language and endpoint to view the snippet.
// (Mockup: Imagine Python, PHP, and other endpoint codes here)
print("Snippet loaded.")
200 OK
{ “success”: true, “received_at”: “2023-10-24T12:00:01Z” }
Built for Scale

Enterprise-grade reliability

♻️

Idempotency Built-in

Safely retry failed requests. Include a messageId in your payload, and our API ensures that the same event is never processed or counted twice.

📦

High-Volume Batching

Processing historical data? Use the /v1/batch endpoint to send up to 10,000 events or profiles in a single HTTP request to minimize network overhead.

🔒

HMAC Security & Verification

Secure your webhook payloads and API calls using HMAC SHA-256 signatures, ensuring data integrity and preventing man-in-the-middle attacks.

⏱️

Global Low Latency

Our API edge nodes are globally distributed. Expect sub-20ms response times regardless of where your backend servers are hosted.

Ready to stream your server data?

Generate your API key, grab the Postman collection, and start sending server-side events to your CDP in minutes.