MyScoop API, Bot & Webhook Reference

curl -X GET "https://myscoop.in/api/health" \
  -H "Accept: application/json"

curl -X POST "https://api.telegram.org/bot<TELEGRAM_BOT_TOKEN>/createChatInviteLink" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "-1001234567890",
    "name": "Order ord_8921a",
    "expire_date": 1729353600,
    "member_limit": 1
  }'

import { createSingleUseInviteLink } from "@/lib/telegram";

// Creates a 60-minute, 1-member link automatically
const response = await createSingleUseInviteLink("-1001234567890", "VIP Member Pass", 60);

if (response.ok && response.result) {
  console.log("Single-use invite link:", response.result.invite_link);
}

import crypto from "crypto";

export function verifyMyScoopWebhook(
  rawBody: string,
  signature: string,
  secret: string
): boolean {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

import hmac
import hashlib

def verify_myscoop_webhook(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode('utf-8'),
        raw_body,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

https://myscoop.in/oauth/authorize?
  client_id=app_89f12ab
  &redirect_uri=https://app.foundersaas.com/api/auth/callback
  &response_type=code
  &scope=read:subscription,user:profile

curl -X POST "https://myscoop.in/api/v1/licenses/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "license_key": "SCP-892F-411B-A92D",
    "instance_id": "macbook-pro-m3-serial"
  }'

{
  "valid": true,
  "product_id": "prod_nextjs_boilerplate",
  "plan": "developer_commercial",
  "customer_email": "dev@company.com",
  "seats_allowed": 2,
  "seats_activated": 1,
  "activated_at": "2026-10-19T14:30:00Z"
}

{
  "id": "evt_982103810",
  "event": "subscription.created",
  "created_at": 1729350000,
  "data": {
    "subscription_id": "sub_8921f0a",
    "customer": {
      "name": "Rohan Sharma",
      "email": "rohan@example.com",
      "phone": "+919876543210"
    },
    "product_id": "prod_saas_crm",
    "plan": "pro_monthly",
    "amount": 99900,
    "currency": "INR",
    "current_period_end": 1731942000
  }
}

curl -X POST https://api.myscoop.in/v1/marketing/broadcasts \
  -H "Authorization: Bearer $MYSCOOP_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "template_id": "flash_discount",
    "audience_filter": { "product_id": "prod_options_algo" },
    "variables": {
      "discount_percent": "25",
      "validity_hours": "24",
      "cta_url": "https://myscoop.in/c/aaravtrades?coupon=FLASH25"
    }
  }'

import { MyScoop } from "@myscoop/sdk";

// Your API key — MyScoop dashboard -> Settings -> API keys. It is YOUR OWN
// project credential: read it from your secret store, keep it server-side,
// and note that no MyScoop server variable is involved (there is no
// MYSCOOP_API_KEY to set on our side).
const scoop = new MyScoop({ apiKey: "msk_live_YOUR_KEY" });

// Trigger high-converting WhatsApp flash drop
const broadcast = await scoop.marketing.broadcasts.create({
  channel: "whatsapp",
  templateId: "flash_discount",
  audienceFilter: { productId: "prod_options_algo" },
  variables: {
    discountPercent: "25",
    validityHours: "24",
    ctaUrl: "https://myscoop.in/c/aaravtrades?coupon=FLASH25",
  },
});

console.log(`Dispatched to ${broadcast.recipientCount} buyers. Cost: ₹${broadcast.costInr}`);