Skip to main content

Overview

OnceHub Developer Center​

The OnceHub Developer Center provides tools and APIs for integrating OnceHub scheduling and booking capabilities into your websites, business workflows and AI agents. Our platform is designed for everyone who wants to build robust integrations that securely access booking data, manage scheduling and automate complex workflows using server-side REST APIs, client-side APIs, and Model Context Protocol (MCP) integrations.

Integration Options​

OnceHub offers a variety of integration approaches. Users can select the method that best aligns with their specific use case and technical environment:

  • Server-Side REST APIs: Best for synchronizing booking data, managing scheduling resources, and automating backend workflows following REST principles.
  • Webhooks: Essential for receiving real-time, event-driven notifications for booking lifecycle events, digital conversation interactions (Chatbots/ Live engagement), and cancellation events to keep your external systems synchronized.
  • Client-Side APIs: Use these to embed OnceHub interfaces directly into web applications and interact with them using client-side event listeners. This approach supports capturing real-time events for chatbots, routing forms and booking pages.
  • URL Parameters & Embedding: A powerful mechanism to fetch data from (pre-filling booking forms) or pass information to redirect parameters after a booking is completed.
  • MCP Server: Designed for integrating OnceHub into Model Context Protocol (MCP) environments for AI-driven scheduling and automation workflows.

Developer Center Structure​

The OnceHub Developer Center is organized into two sections:

Documentation​

Covers shared concepts and platform standards across all integration types:

  • Authentication and API keys
  • Client configuration and embedded components
  • URL parameter reference
  • API versioning, rate limits, pagination, and error handling
  • MCP integration guidelines
  • Webhook event delivery and validation

API Reference​

Provides detailed endpoint documentation for OnceHub products:

Each reference includes supported endpoints, parameters, authentication requirements and example responses.

Getting Started​

Select your preferred integration method to begin. Most methods require an active OnceHub account and valid API credentials.

To Use REST API or MCP Server​

  1. Sign up for a OnceHub account if you don’t have one.

  2. Create your API keys using the Authentication guide. You can maintain up to 25 active keys to segregate environments (Staging vs. Production) and manage third-party vendors securely.

  3. Choose between REST APIs for standard integrations or the MCP Server for AI-driven workflows.

To Use Client-Side API​

  • Use the Website embed feature to publish your Booking page or Booking calendar directly on your site.
  • Add a JavaScript function to your embed code to collect real-time booking confirmation data or trigger custom analytics.

To Use Webhooks​

Webhooks can be configured through the OnceHub application interface for a quick setup or via the API.

  • To configure your webhooks directly in the OnceHub Application, define your webhook URL (must be https://), select your triggers from the provided list, and save your Webhook Secret to verify data authenticity.

  • Use the Webhooks API to create a new subscription (via POST request). You must define your destination url and an array of event types (e.g., booking.scheduled) within the JSON request body. Once created, retrieve the signing_secret from the API response to implement signature verification on your server.

To Use URL Parameters & Embedding​

  • Map your custom field names in the Booking Calendar's form settings to ensure data is correctly identified.
  • Append parameters to your OnceHub URL to push data and pre-fill guest information in both Booking Forms and Routing Forms for a frictionless scheduling experience.
  • Configure a redirect page to automatically capture system-generated data and submission data via URL parameters upon booking completion.