Build on it, not around it
A REST API with scoped keys, signed webhooks with a replayable log, and a plugin SDK that gives you the same surface we build on.
curl https://api.shubham.ai/v1/contacts \
-H "Authorization: Bearer sk_live_••••••••" \
-H "Content-Type: application/json" \
-G -d "limit=25" -d "segment=repeat-buyers"
# Every response is tenant-scoped by the key that made the request.
# There is no account_id parameter — a key cannot reach outside its tenant.- API endpoints
- 47
- Platform events
- 46
- Extension slots
- 18
- Version support
- 12 mo
Published by plugins
Emitted by plugins
Surfaces you can extend
After a new version ships
Designed so the dangerous mistakes are impossible
Most integration bugs are authorisation bugs. The shapes here make the common ones unrepresentable.
Scoped API keys
Grant only the permissions a key needs. Set a rate limit and an expiry per key.
Tenant-scoped by construction
A key belongs to a tenant. There is no account parameter to get wrong.
Signed webhooks
HMAC signature with a timestamp, so replays outside a five-minute window are rejectable.
Automatic retries
Failed deliveries retry with backoff, and every attempt is in a log you can replay.
Event catalogue
Around 45 platform events. New plugin events appear automatically — no release needed.
One API for every client
Your Android and iOS apps use exactly these endpoints. There is no web-only surface.
Verify the signature. Always.
Every delivery is signed with an HMAC over the timestamp and raw body. Verifying it is four lines, and skipping it means anyone who learns your URL can post to it. We document it here rather than in a footnote for that reason.
- HMAC-SHA256 over `timestamp.rawBody`
- Five-minute window rejects replayed deliveries
- Constant-time comparison to avoid timing leaks
- Stable event id in every payload for idempotency
- Full delivery log with one-click replay
// Verify the signature before you trust the body.
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(rawBody: string, header: string, secret: string) {
const [ts, sig] = header.split(",").map((p) => p.split("=")[1]);
// Reject replays outside a five-minute window.
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const expected = createHmac("sha256", secret)
.update(`${ts}.${rawBody}`)
.digest("hex");
return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
}Subscribe to what actually happened
Events are facts in the past tense. Around 45 today — and a plugin you install adds its own without a platform release.
conversation.startedAn inbound message opened a new conversation.conversation.assignedA conversation was routed to an agent.campaign.sentA broadcast finished, with delivered and failed counts.message.failedA message could not be delivered, with the error code.lead.stage_changedA deal moved between pipeline stages.payment.completedA payment succeeded, with amount and currency.ai.response_generatedAn AI completion finished, with tokens and cost.template.status_changedMeta approved or rejected a template.The full catalogue, with payload shapes, is in the API reference.
Extend the product without forking it
A plugin owns its routes, permissions, navigation, settings, events, workflow nodes, AI tools and API endpoints. It contributes to shared surfaces through typed extension slots and talks to other plugins through events — never through imports.
import { definePlugin } from "@shubham-ai/sdk";
import { Boxes } from "lucide-react";
export default definePlugin({
id: "acme.loyalty",
name: "Acme Loyalty",
version: "1.0.0",
category: "crm",
summary: "Points, tiers and rewards.",
icon: Boxes,
status: "stable",
dependencies: ["crm.contacts"],
permissions: ["crm.view", "crm.manage"],
availableTo: ["business"],
pricing: { model: "addon", fromMinor: 39900, unit: "month" },
// Contribute to shared surfaces without importing them.
extensions: [
{ slot: "workflow.node", value: {
id: "acme.loyalty.award", kind: "action", label: "Award points",
category: "Loyalty", icon: Boxes, outputs: ["next"],
description: "Add points to the contact in context.",
fields: [{ key: "points", label: "Points", type: "number", required: true }],
} },
{ slot: "ai.tool", value: {
id: "acme.loyalty.balance", name: "check_points_balance",
description: "Return the contact's current points balance.",
parameters: [{ name: "contactId", type: "string", description: "Contact", required: true }],
execute: async (args, scope) => getBalance(args.contactId, scope),
} },
],
// React to other plugins through events, never imports.
subscribes: {
"payment.completed": (e) => awardPoints(e.payload),
"deal.won": (e) => awardBonus(e.payload),
},
});Integration questions
Get a sandbox key and try it
Sandbox keys hit the same endpoints with the same shapes — nothing is delivered and nothing is billed.
No credit card required · 14-day trial · Cancel anytime