Public API

Push leads into ScaleNova CRM from any external tool — Pabbly Connect, AiSensy, JustDial (where a custom webhook is available on your plan), a Google Sheets Apps Script, or your own code.

Getting a key

Go to Settings → API Keys in the dashboard (org ADMIN role required) and click Generate. The full key is shown exactly once — copy it immediately, it can't be retrieved again. If you lose it, revoke it and generate a new one.

Ingest / update a lead

POST https://crm.scalenova.co.in/api/public/v1/leads/{your-api-key}
Content-Type: application/json

The key is embedded directly in the URL path, not sent as a header — most no-code webhook senders can only POST to a URL and can't set custom headers. Treat the full URL, including the key, as a secret.

Request body

Leads created this way always start in the FRESH stage, unassigned. If a lead with the same phone already exists in your organization, the endpoint updates it instead of creating a duplicate and logs a new activity entry.

Example

curl -X POST \
  https://crm.scalenova.co.in/api/public/v1/leads/sk_live_xxxxxxxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rahul Sharma",
    "phone": "9876543210",
    "email": "rahul.sharma@example.com",
    "source": "justdial",
    "actionName": "Lead Created",
    "notes": "Asked about weekend batch",
    "customFields": {
      "budget_range": "50k-1L"
    }
  }'

Custom Actions

Log a structured, org-defined activity (Settings → Custom Actions) against the lead in the same request. Each entry in customActions needs a type and a fields object:

Each field's expected value depends on its type:

A field can be omitted or sent as null — that's only rejected if the field is marked mandatory on the definition.

curl -X POST \
  https://crm.scalenova.co.in/api/public/v1/leads/sk_live_xxxxxxxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rahul Sharma",
    "phone": "9876543210",
    "source": "website",
    "customActions": [
      {
        "type": "ACTION_1001",
        "fields": { "course_name": "SUPER_30", "batch": "Weekend" }
      }
    ]
  }'

A bad field value comes back as a 400, with the offending key(s) named in fieldErrors:

{
  "error": "One or more custom field values are invalid.",
  "fieldErrors": {
    "fieldValues.batch": ["\"Batch\" must be one of: Weekend, Weekday."]
  }
}

An unknown or archived type code returns a plain 400: { "error": "No active custom action with code 1001." }.

Success response — 201 Created

{
  "lead": {
    "id": "clx...",
    "name": "Rahul Sharma",
    "phone": "9876543210",
    "source": "justdial",
    "stage": "FRESH",
    "assignee": null,
    "actions": [],
    "createdAt": "2026-07-22T...",
    "updatedAt": "2026-07-22T..."
  }
}

Errors

Rate limit: 60 requests per minute per key, fixed window.

Triggering a workflow directly

If a Workflow's trigger node is set to API Trigger, fire it directly with the same org API key:

POST https://crm.scalenova.co.in/api/public/v1/workflows/{workflowId}/trigger/{your-api-key}
Content-Type: application/json

Body: either { "leadId": "..." } for an existing lead, or { "name": "...", "phone": "...", "email": "..." } to match-or-create one. Returns { "ok": true, "leadId": "..." }.

Sending a WhatsApp OTP

If your org has connected a WhatsApp Business Account (Settings → WhatsApp) and has an approved AUTHENTICATION template, send a one-time code to a user's WhatsApp from your own backend using the same org API key:

POST https://crm.scalenova.co.in/api/public/v1/whatsapp/send-otp/{your-api-key}
Content-Type: application/json

This is a send-only relay. It does not generate, store, or verify the code — you create the OTP, this endpoint delivers it, and you verify it back in your own system when the user types it in.

Copy code template (the default):

curl -X POST \
  https://crm.scalenova.co.in/api/public/v1/whatsapp/send-otp/sk_live_xxxxxxxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "templateName": "otp_verification",
    "languageCode": "en_US",
    "otpCode": "482913"
  }'

One-tap autofill (URL button) template — add otpButtonType:

curl -X POST \
  https://crm.scalenova.co.in/api/public/v1/whatsapp/send-otp/sk_live_xxxxxxxxxxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "templateName": "otp_verification",
    "languageCode": "en_US",
    "otpCode": "482913",
    "otpButtonType": "url"
  }'

Success response — 200 OK:

{ "sent": true, "wabaMessageId": "wamid.HBgL..." }