Get booking in under an hour.

React, Next.js, Astro

If your site is built with a React-based framework, use the component directly.

npm install @creno/react

import { BookingWidget } from "@creno/react";
import "@creno/react/style.css";

export default function BookingPage() {
  return (
    <BookingWidget
      apiUrl="https://api.crenoapp.com"
      apiKey="pk_live_..."
    />
  );
}

Props

Vue

Vue 3 wrapper around the same component. Auto-loads the embed script, no <script> tag to add yourself.

npm install @creno/vue

<script setup>
import { BookingWidget } from "@creno/vue";
</script>

<template>
  <BookingWidget
    api-url="https://api.crenoapp.com"
    api-key="pk_live_..."
    @booked="(booking) => console.log(booking.id)"
  />
</template>

Props

Any other website

Plain HTML, Shopify, Webflow, Squarespace, or anywhere else you can paste a script tag. No build step, no framework required.

<script src="https://cdn.crenoapp.com/embed.js" defer></script>

<creno-widget
  api-url="https://api.crenoapp.com"
  api-key="pk_live_..."
></creno-widget>

Renders inside a Shadow DOM, so it can never clash with your site's own CSS in either direction: your styles won't leak in, and the widget's styles won't leak out.

Attributes

Theming

Every color, radius, and font is a CSS custom property. Override them from your own stylesheet, with no build config and no component props needed, and it works identically for both the React component and the script embed.

creno-widget, .my-booking-page {
  --pbw-color-accent: #b8452f;
  --pbw-color-accent-hover: #963a27;
  --pbw-radius-lg: 8px;
}

Node.js

TypeScript client, zero runtime dependencies (Node 18+'s native fetch). A distinct error class per error type, same taxonomy as the Python kit.

npm install @creno/node

import { CrenoClient, CrenoConflictError } from "@creno/node";

const client = new CrenoClient("pk_live_...");

const availability = await client.getAvailability({ from: "2026-08-01", to: "2026-08-07" });

try {
  const booking = await client.createBooking({
    startAt: availability.slots[0].startAt,
    customerName: "Jane Doe",
    customerEmail: "jane@example.com",
  });
} catch (err) {
  if (err instanceof CrenoConflictError) {
    // that slot was just taken, re-check availability and retry
  }
}

Python

A typed client for any Python backend: normal methods, plus a distinct exception per error type (slot taken, plan limit, too many requests...) instead of parsing status codes by hand.

pip install creno

from creno import CrenoClient

client = CrenoClient(api_key="pk_live_...")

availability = client.get_availability(from_="2026-08-01", to="2026-08-07")
booking = client.create_booking(
    start_at=availability.slots[0].start_at,
    customer_name="Jane Doe",
    customer_email="jane@example.com",
)

API reference

Both the widget and the script embed call this same REST API underneath. If you're building your own UI, or integrating from a backend (Python, Ruby, PHP, Go, whatever), you can call it directly, no client library required, just an HTTP client.

Authentication

Every request needs your publishable key in the X-API-Key header. That key identifies your account; the real protection is the origin allowlist you configure in the dashboard, which applies to requests coming from a browser (CORS). Server-side calls (Python, etc.) never go through a browser, so origin checking doesn't apply to them, still keep your key server-side and out of source control.

X-API-Key: pk_live_...

Base URL

https://api.crenoapp.com

Endpoints

[
  { "id": "...", "resourceId": "...", "name": "Haircut", "active": true, "sortOrder": 0 }
]

{
  "resourceId": "...",
  "timezone": "America/Toronto",
  "slots": [
    { "startAt": "2026-08-03T13:00:00.000Z", "endAt": "2026-08-03T13:30:00.000Z" }
  ]
}

{
  "startAt": "2026-08-03T13:00:00.000Z",
  "customerName": "Jane Doe",
  "customerEmail": "jane@example.com",
  "customerPhone": "+1 514 555 0100",
  "notes": "First visit",
  "resourceId": null,
  "serviceTypeId": null,
  "lang": "en"
}

Rate limits

Error responses

Every error returns a JSON body with an error field. The ones that matter for integration:

Any other language

No official kit for Ruby, Go, PHP, etc., the REST API itself is enough, with any HTTP client:

curl "https://api.crenoapp.com/v1/public/availability?from=2026-08-01&to=2026-08-07" \
  -H "X-API-Key: pk_live_..."

curl -X POST "https://api.crenoapp.com/v1/public/bookings" \
  -H "X-API-Key: pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"startAt":"2026-08-03T13:00:00.000Z","customerName":"Jane Doe","customerEmail":"jane@example.com"}'