SDK

JavaScript SDK

Use the ColdDMCalculator Outreach Intelligence API in your JavaScript projects — Node.js, browser, or edge functions.

View API Docs View Examples

Getting Started

JavaScript SDK Overview

The JavaScript SDK provides a simple interface to the ColdDMCalculator Outreach Intelligence API. Use it to forecast replies, booked calls, clients, revenue, campaign scores, and optimization recommendations.

Coming soon: The JavaScript SDK package is not yet published to npm. The code examples below show how to integrate directly with the REST API using native fetch or axios. npm install @colddmcalculator/sdk will be available in a future release.

Installation

npm (coming soon)

# Coming soon — placeholder only
npm install @colddmcalculator/sdk

Authentication

Include your API key in the Authorization header of every request.

Header

Authorization: Bearer YOUR_API_KEY

Forecast Example

JavaScript — DM Forecast

const response = await fetch("https://api.colddmcalculator.com/v1/dm/forecast", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    dms_sent: 1000,
    reply_rate: 12,
    positive_reply_rate: 35,
    call_booking_rate: 25,
    close_rate: 20,
    average_client_value: 1500
  })
});

const data = await response.json();
console.log(data);
// {
//   estimated_replies: 120,
//   estimated_positive_replies: 42,
//   estimated_booked_calls: 10,
//   estimated_clients: 2,
//   estimated_revenue: 3000,
//   campaign_score: 82,
//   risk_level: "medium",
//   recommendations: [...]
// }

Score Example

JavaScript — Campaign Score

const response = await fetch("https://api.colddmcalculator.com/v1/dm/score", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    channel: "linkedin",
    audience_quality: "high",
    personalization_level: "medium",
    offer_clarity: "high",
    follow_up_count: 3,
    daily_dm_volume: 30
  })
});

const data = await response.json();
console.log(data);
// {
//   campaign_score: 85,
//   deliverability_risk: "low",
//   conversion_confidence: "high",
//   strengths: [...],
//   issues: [...],
//   next_steps: [...]
// }

Error Handling

JavaScript — Error Handling

try {
  const response = await fetch("https://api.colddmcalculator.com/v1/dm/forecast", {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ dms_sent: -1 }) // invalid input
  });

  if (!response.ok) {
    const error = await response.json();
    console.error(error.error.code, error.error.message);
    // "invalid_input" "dms_sent must be greater than 0"
  } else {
    const data = await response.json();
    console.log(data);
  }
} catch (err) {
  console.error("Network error:", err);
}