Examples

Cold DM API Examples

Practical examples of using the ColdDMCalculator API for forecasting, scoring, and optimizing cold DM campaigns across different channels and use cases.

View API Docs Try the Calculator
Use Cases

API Examples by Use Case

Forecast LinkedIn DM Campaign

Estimate replies, booked calls, clients, and revenue for a B2B LinkedIn outreach campaign targeting agency owners.

Request
{ "dms_sent": 500, "reply_rate": 15, "positive_reply_rate": 30, "call_booking_rate": 20, "close_rate": 25, "average_client_value": 2000, "channel": "linkedin" }
Response
{ "estimated_replies": 75, "estimated_positive_replies": 22, "estimated_booked_calls": 4, "estimated_clients": 1, "estimated_revenue": 2000, "campaign_score": 74, "risk_level": "low" }

This example shows a realistic LinkedIn outreach campaign. A 15% reply rate is achievable with good targeting and personalization on LinkedIn.

Learn more in the docs →

Forecast Instagram DM Campaign

Estimate outcomes for an Instagram DM outreach campaign targeting creators and influencers.

Request
{ "dms_sent": 1000, "reply_rate": 8, "positive_reply_rate": 25, "call_booking_rate": 15, "close_rate": 20, "average_client_value": 1500, "channel": "instagram" }
Response
{ "estimated_replies": 80, "estimated_positive_replies": 20, "estimated_booked_calls": 3, "estimated_clients": 0, "estimated_revenue": 0, "campaign_score": 62, "risk_level": "medium" }

Instagram typically has lower reply rates than LinkedIn. At 1,000 DMs with an 8% reply rate, you might get 0-1 client. Consider higher volume or improving your opener.

Learn more in the docs →

Score an Agency Outreach Campaign

Score campaign quality before launching to identify strengths, weaknesses, and next steps.

Request
{ "channel": "linkedin", "audience_quality": "high", "personalization_level": "medium", "offer_clarity": "high", "follow_up_count": 3, "daily_dm_volume": 30 }
Response
{ "campaign_score": 85, "deliverability_risk": "low", "conversion_confidence": "high", "strengths": [ "High quality audience targeting", "Clear and compelling offer" ], "issues": [ "Personalization could be improved" ], "next_steps": [ "Add personalization to the first message", "Consider reducing follow-ups to 2 max" ] }

Scoring helps catch issues before you invest time and resources. This campaign scores well but could improve personalization.

Learn more in the docs →

Estimate Booked Calls From Cold DMs

Forecast how many booked calls a campaign will generate across different scenarios.

Request
{ "dms_sent": 2000, "reply_rate": 10, "positive_reply_rate": 30, "call_booking_rate": 25, "close_rate": 20, "average_client_value": 2500 }
Response
{ "estimated_replies": 200, "estimated_positive_replies": 60, "estimated_booked_calls": 15, "estimated_clients": 3, "estimated_revenue": 7500, "campaign_score": 78, "risk_level": "low" }

At 2,000 DMs with a 10% reply rate and standard conversion rates, you can expect about 15 booked calls and 3 new clients.

Learn more in the docs →

Forecast Creator Partnership Outreach

Estimate partnership responses from creator outreach campaigns on Instagram.

Request
{ "dms_sent": 300, "reply_rate": 20, "positive_reply_rate": 40, "call_booking_rate": 10, "close_rate": 50, "average_client_value": 5000, "channel": "instagram", "campaign_type": "creator_partnership" }
Response
{ "estimated_replies": 60, "estimated_positive_replies": 24, "estimated_booked_calls": 2, "estimated_clients": 1, "estimated_revenue": 5000, "campaign_score": 80, "risk_level": "low" }

Creator partnerships often have higher reply rates since the offer is mutually beneficial. At 300 targeted DMs, you could land 1-2 partnerships.

Learn more in the docs →

Build a Cold DM ROI Dashboard

Use the API as a data source for a dashboard that tracks forecasted vs actual campaign performance.

Dashboard Data Source
// Poll API with campaign assumptions GET /v1/dm/forecast // Returns JSON with all KPIs: - estimated_replies - estimated_positive_replies - estimated_booked_calls - estimated_clients - estimated_revenue - campaign_score - risk_level - recommendations
Dashboard Metrics
// Compare forecast vs actual "forecasted_clients": 3 "actual_clients": 2 "forecast_accuracy": "75%" // Campaign score trend "score_trend": "improving"

Use the API to power custom dashboards in tools like Google Data Studio, Grafana, or your own app.

Learn more in the docs →

Add Forecasting to a CRM

Embed campaign forecasting into HubSpot, Salesforce, or a custom CRM workflow.

Send campaign data from your CRM to the API via a webhook or custom action, then store the forecasted results back in the CRM for reporting. This lets sales teams plan outreach volume and set realistic pipeline targets based on data, not guesswork.

Learn more in the docs →

Create an Agency Client Report

Generate a campaign planning report for clients showing forecasted outcomes based on proposed outreach assumptions.

Agencies can use the API to generate pre-campaign reports for clients. Show estimated replies, booked calls, and expected ROI so clients can make informed decisions about outreach investment before any DMs are sent.

Learn more in the docs →