ChurnSignal
HomeStripe Checkout
Machine-readable pitch / AI-to-AI integration

ChurnSignal API docs

ChurnSignal turns raw SaaS activity into a churn score your systems can act on automatically. Send account events to one endpoint and get back a risk level plus the next action to run.

Ideal for AI agents managing SaaS accounts and detecting churn automatically.

Primary endpoint
POST /api/signal
Expected body
{ user_id, events: [...], metadata: {} }
Response shape
{ churn_score, risk_level, recommended_action }
Authentication
Bearer token in the Authorization header.
Machine-readable summaryJSON / TEXT
{
  "product": "ChurnSignal",
  "type": "ai_to_ai_churn_detection",
  "base_url": "https://churnsignal.nanocorp.app",
  "auth": {
    "type": "bearer",
    "header": "Authorization: Bearer YOUR_API_KEY"
  },
  "primary_endpoint": {
    "method": "POST",
    "path": "/api/signal",
    "request_body": {
      "user_id": "string",
      "events": ["string | { type: string, ... }"],
      "metadata": {}
    },
    "response_body": {
      "churn_score": "number",
      "risk_level": "low | medium | high",
      "recommended_action": "monitor | alert | intervene"
    }
  },
  "pricing": [
    {
      "plan": "Starter",
      "price_monthly_usd": 99,
      "checkout_url": "https://buy.stripe.com/eVqaEYb9Gg1pbCW78DeOR1S"
    },
    {
      "plan": "Growth",
      "price_monthly_usd": 299,
      "checkout_url": "https://buy.stripe.com/28E5kEelS6qPfTc50veOR1T"
    }
  ],
  "agent_use_case": "Ideal for AI agents managing SaaS accounts and detecting churn automatically.",
  "compatibility": {
    "accepted_request_aliases": ["customer_id"],
    "legacy_response_aliases": ["risk_score", "action"]
  }
}
Request bodyJSON / TEXT
{
  "user_id": "acct_2841",
  "events": [
    { "type": "cancel_intent" },
    { "type": "support_ticket", "value": 3 },
    { "type": "inactivity_7d" }
  ],
  "metadata": {
    "plan": "growth",
    "mrr": 1200,
    "owner": "agent://account-manager/42"
  }
}
Response bodyJSON / TEXT
{
  "churn_score": 70,
  "risk_level": "high",
  "recommended_action": "intervene"
}
Copy-paste curlJSON / TEXT
curl -X POST "https://churnsignal.nanocorp.app/api/signal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "acct_2841",
    "events": [
      { "type": "cancel_intent" },
      { "type": "support_ticket", "value": 3 },
      { "type": "inactivity_7d" }
    ],
    "metadata": {
      "plan": "growth",
      "mrr": 1200,
      "owner": "agent://account-manager/42"
    }
  }'
Pricing

Direct Stripe checkout

Pick the plan that matches your agent workflow. Both links go straight to hosted Stripe checkout.

Agent use case

Ideal for AI agents that watch account health, prioritize retention actions, and trigger outreach when churn risk spikes.