Guides

Step-by-step tutorials and integration examples to help you build with the Renu Platform API.

Quick Start

Get up and running with the Renu API in minutes. This guide walks you through authentication, making your first API call, and handling responses.

# 1. Get your API key
# Sign up at https://dashboard.studioimagesalon.ca

# 2. Make your first request
curl -X GET "https://api.studioimagesalon.ca/v1/businesses" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json"
// 3. Using JavaScript/TypeScript
const response = await fetch(
  'https://api.studioimagesalon.ca/v1/businesses',
  {
    headers: {
      'Authorization': 'Bearer your-api-key',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data.businesses);

Webhook Setup

Receive real-time notifications when events happen in your Renu account using webhooks. Configure your webhook URL in the developer dashboard.

Supported Webhook Events

  • booking.created — New booking created
  • booking.confirmed — Booking payment confirmed
  • booking.cancelled — Booking cancelled
  • booking.completed — Appointment marked complete
  • payment.succeeded — Payment processed
  • payment.failed — Payment failed
  • review.submitted — New review posted
// Example webhook payload
{
  "event": "booking.confirmed",
  "timestamp": "2026-06-25T10:30:00Z",
  "data": {
    "id": "book_abc123",
    "businessId": "biz_xyz789",
    "clientId": "cli_123",
    "serviceId": "svc_456",
    "startTime": "2026-06-28T14:00:00Z",
    "totalAmount": 6500
  }
}

Integration Examples

Booking Flow Integration

Implement a complete booking flow with service selection, staff choice, time slot availability, and payment.

// 1. List services for a business
GET /businesses/{businessId}/services

// 2. Get available time slots
GET /businesses/{businessId}/slots?date=2026-06-28&serviceId={serviceId}

// 3. Create booking with payment
POST /bookings
{  businessId, serviceId, staffId, startTime, paymentIntentId}

POS Integration

Build a point-of-sale system to handle in-store payments, tips, and generate receipts.

// Create instant checkout
POST /payments/checkout
{
  businessId: "biz_xyz789",
  amount: 8500, // $85.00 CAD
  tip: 2000, // $20.00 tip
  services: ["Haircut", "Blowout"],
  clientId: "cli_123" // Optional loyalty tracking
}

AI Receptionist Integration

Power your booking flow with AI that can handle natural language queries and appointment scheduling.

// Send a booking request via chat
POST /ai/receptionist
{
  businessId: "biz_xyz789",
  message: "I want to book a haircut with Emma on Saturday at 2pm",
  clientId: "cli_123"
}

SDKs & Libraries

JavaScript / TypeScript

Official client library with full TypeScript support

npm install @renu/api-client

React Native

Pre-built components for mobile apps

npm install @renu/react-native

Python

Python SDK for backend integrations

pip install renu-api
Browse API Reference →Back to Overview →