Skip to main content
A clinic in Lagos just set up their AI receptionist

API Documentation

Integrate Wittyscale into your existing tools and workflows with our RESTful API and SDKs.

API v2 · All systems operationalStatus Page

Quick Start

Get up and running with Wittyscale in minutes using our Node.js SDK.

JavaScript / TypeScript
// Install SDK
npm install @wittyscale/sdk

// Initialize
import { Wittyscale } from '@wittyscale/sdk';

const client = new Wittyscale({
  apiKey: process.env.WITTYSCALE_API_KEY,
});

// List recent calls
const calls = await client.calls.list({
  limit: 20,
  status: 'completed',
});

// Book an appointment
const appointment = await client.appointments.create({
  contactId: 'cont_123',
  startsAt: '2026-06-15T10:00:00Z',
  duration: 30,
  notes: 'Initial consultation',
});

console.log(appointment.id); // appt_abc123

Authentication

All API requests require an API key. Pass it via the Authorization header.

Authorization: Bearer YOUR_API_KEY

Find your API key in Settings → API Keys.

Webhooks

Wittyscale sends webhook events to your endpoint for real-time updates.

call.started
call.completed
call.missed
appointment.created
appointment.cancelled
message.received

Need help with the API?

Our developer support team is available via email and Discord.

Email SupportJoin Discord