Node.js SDK

import { SlotflowClient } from "slotflow";
const client = new SlotflowClient({
  token: "sk_live_your_api_key",
});
// Find available slots
const { slots } = await client.slots.getAvailableSlots({
  humanId: "HUMAN_ID",
  date_from: "2026-03-15",
  date_to: "2026-03-20",
  duration: 30,
});
// Book the first slot
const booking = await client.bookings.createBooking({
  human_id: "HUMAN_ID",
  starts_at: slots[0].starts_at,
  duration: 30,
  attendee_name: "Alex Rivera",
  attendee_email: "alex@startup.io",
  metadata: {
    lead_id: "lead_8294",
    source: "ai_sdr",
  },
});

import { SlotflowClient, Slotflow } from "slotflow";
try {
  await client.bookings.createBooking({ /* ... */ });
} catch (error) {
  if (error instanceof Slotflow.ConflictError) {
    // 409 — slot was just booked by someone else
    // Re-query slots and try the next one
  }
  if (error instanceof Slotflow.PaymentRequiredError) {
    // 402 — booking limit reached
  }
  if (error instanceof Slotflow.NotFoundError) {
    // 404 — human not found
  }
  if (error instanceof Slotflow.UnprocessableEntityError) {
    // 422 — validation error (outside working hours, invalid duration, etc.)
  }
}

const client = new SlotflowClient({
  token: "sk_live_your_api_key",
  // Override the default timeout (seconds)
  timeoutInSeconds: 30,
  // Override the default retry count
  maxRetries: 3,
  // Custom fetch (e.g. for edge runtimes)
  fetch: myCustomFetch,
});

await client.bookings.listBookings({}, {
  timeoutInSeconds: 10,
  maxRetries: 0,
});