Node.js / TypeScript SDK

npm install @essal/sdk
# or
yarn add @essal/sdk

import { EssalClient } from "@essal/sdk";

const client = new EssalClient({
  apiKey: process.env.ESSAL_API_KEY,
  environment: "production", // "production" | "staging" | "sandbox"
});

// List documents
const { data: docs } = await client.office.documents.list({ limit: 20 });

// Create a document
const doc = await client.office.documents.create({
  title: "Q4 Planning",
  content: "<h1>Q4 Planning</h1>",
  content_type: "html",
});

// Create a contact
const contact = await client.sales.contacts.create({
  display_name: "Jane Smith",
  email: "jane@acmecorp.com",
  organization_name: "Acme Corp",
});

// Move a deal to a new stage
await client.sales.deals.update("deal_01HXYZAAA", {
  stage_id: "stg_01HXYZ3333",
});

// Create a task
const task = await client.project.tasks.create("proj_01HXYZ9876", {
  title: "Design review",
  priority: "high",
  assignee_id: "usr_01HXYZ1111",
});

for await (const doc of client.office.documents.list({ limit: 50 })) {
  console.log(doc.title);
}

import { verifyWebhookSignature } from "@essal/sdk";

app.post("/webhook", (req, res) => {
  const isValid = verifyWebhookSignature(
    req.rawBody,
    req.headers["x-essal-signature"],
    process.env.ESSAL_WEBHOOK_SECRET
  );
  if (!isValid) return res.status(401).send("Invalid signature");
  // process event...
  res.sendStatus(200);
});