Skip to main content

Welcome to BookingShake API

The BookingShake API provides a simple, RESTful interface for integrating event and booking management into your applications. Whether you’re building a custom booking form, integrating with your existing systems, or automating event creation, our API makes it easy.

Base URL

All API requests should be made to:
https://api.bookingshake.io/api

API Version

Current version: v1.0

What You Can Do

Key Features

  • Event Creation: Create one or multiple events in a single request
  • Contact Management: Link events to existing contacts or create new ones
  • Draft Quotations: Include products to create draft quotations
  • Resource Management: Access booking sources, spaces, and statuses
  • Custom Fields: Support for venue-specific custom fields
  • Group Bookings: Create multiple events that are automatically grouped together
  • Webhooks: Real-time event notifications for account and contact changes

Getting Started

1

Get Your API Key

Navigate to Settings > Integrations in your BookingShake dashboard and copy your API key.
2

Read the Authentication Guide

Learn how to authenticate your requests using Bearer tokens.View Authentication Guide →
3

Make Your First Request

Follow our quickstart guide to create your first event.View Quickstart Guide →
4

Explore Endpoints

Dive into the API reference to discover all available endpoints.Browse API Reference →

Need Help?

Important Data Formats

When creating events with products for draft quotations, prices and VAT must use specific formats:Prices (price_without_tax):
  • Provided in cents/centimes, not euros/dollars
  • Example: €150.00 = 150000 cents
  • Example: €35.50 = 3550 cents
VAT (vat):
  • Provided in basis points (1/100th of a percent), not percentages
  • Example: 20% VAT = 2000 basis points
  • Example: 10% VAT = 1000 basis points
  • Example: 5.5% VAT = 550 basis points
  • Valid range: 0 to 10000 (0% to 100%)
Why this format? This ensures precision for financial calculations and avoids floating-point rounding errors.
All dates and times must follow specific formats:Dates:
  • Format: DD-MM-YYYY
  • Example: "15-03-2025" for March 15, 2025
Times:
  • Format: HH:mm (24-hour format)
  • Example: "14:30" for 2:30 PM
  • Example: "09:00" for 9:00 AM

Rate Limits

The BookingShake API implements rate limiting to ensure fair usage and service quality:
  • POST /events/create: 10 requests per minute
  • GET endpoints (sources, spaces, status, fields): 60 requests per minute
Rate limit information is provided in response headers. See the Rate Limiting Guide for details.

API Stability

The BookingShake API is production-ready and actively maintained. We’re committed to backward compatibility and will announce any breaking changes well in advance.