Integrations · Node.js SDK

Official Node.js SDK

@vaidesk/sdk-node package. Typed, with helpers for HMAC webhook signature verification and structured error handling.

Install

bash

npm install @vaidesk/sdk-node

Typed client

All operations exposed as typed methods. Returns validated at runtime. Helpers for webhook signature verification.

Structured errors

Every error has type, code, message, param, doc_url. Consistent codes: authentication_error, permission_error, invalid_request_error, rate_limit_error, idempotency_error.

SSE alternative

For dashboards that prefer pull instead of webhook: /v1/events/stream long-lived. Last-Event-Id to resume.

Example: Node.js client

typescript

import { VAiDeskClient } from '@vaidesk/sdk-node';

const client = new VAiDeskClient({
  apiKey: process.env.VAIDESK_API_KEY!,
});

const conversation = await client.conversations.create({
  externalUserId: 'user_123',
  subject: 'Question about plan',
  initiatedBySide: 'end_user',
  metadata: { plan: 'pro', signupAt: '2026-06-28' },
});

console.log(conversation.id);

Ready to integrate robust customer support into your product?

Tell us about your case. We get back within one business day.

Talk to sales contact@vaidesk.com