# Makeplans API > API documentation for Makeplans — online booking for appointments, classes and events. ## Full Documentation - [Complete documentation](https://developer.makeplans.com/llms-full.txt): All canonical pages in one Markdown document. ## Overview - [Makeplans API](https://developer.makeplans.com/): Build booking integrations with the Makeplans API — guides, endpoint reference and examples for appointments, classes and events. ## Guide - [Get Started](https://developer.makeplans.com/guide/getting-started/): Get started with the Makeplans API — sign up for a test account, enable the API and get your API-Key. - [Public and Private API](https://developer.makeplans.com/guide/public-and-private-api/): The two Makeplans APIs — the authenticated private API for integrations and the read-only public API for websites — and their base URLs. - [Data Formats](https://developer.makeplans.com/guide/data-formats/): Input and output formats for the Makeplans API — JSON output, JSON or form data input, all UTF-8. - [Date Handling](https://developer.makeplans.com/guide/date-handling/): How the Makeplans API handles dates — ISO 8601 formats, account time zones and recommended input format. - [Custom Data](https://developer.makeplans.com/guide/custom-data/): Store custom key/value data on bookings, people, services, resources, events and other objects in Makeplans. - [Authentication](https://developer.makeplans.com/guide/authentication/): Authenticate with the private Makeplans API by sending your account API-Key as a Bearer token. - [Identification](https://developer.makeplans.com/guide/identification/): Every Makeplans API request must include a User-Agent header identifying your application. - [Example Requests](https://developer.makeplans.com/guide/example-requests/): Example requests to the Makeplans API — reading data with GET and creating objects with POST. - [Rate Limiting](https://developer.makeplans.com/guide/rate-limiting/): Rate limiting in the Makeplans API and how to handle HTTP 429 responses. - [Errors](https://developer.makeplans.com/guide/errors/): HTTP status codes and error responses from the Makeplans API, and how to handle them. - [Pagination](https://developer.makeplans.com/guide/pagination/): Pagination in the Makeplans API — page sizes, the page parameter and RFC 8288 Link headers. - [Synchronisation](https://developer.makeplans.com/guide/synchronisation/): Best practices for synchronising bookings and people between Makeplans and another system. - [API Libraries](https://developer.makeplans.com/guide/api-libraries/): Community-built client libraries for the Makeplans API, including Node.js, PHP and Go. - [Webhooks guide](https://developer.makeplans.com/guide/webhooks/): Receive HTTP POST callbacks from Makeplans when bookings and other resources change — webhook concepts, payload and configuration. - [MCP server (AI assistants)](https://developer.makeplans.com/guide/mcp/): Connect Claude, ChatGPT or any MCP-compatible AI assistant to Makeplans — endpoint, authentication, available tools and client setup. - [Booking site analytics events](https://developer.makeplans.com/guide/booking-site-analytics/): dataLayer and GA4 events emitted by the hosted booking site — event reference, dispatch rules and URL structure for Google Tag Manager setups. - [Custom room display](https://developer.makeplans.com/guide/room-display/): Build a custom room display with the Makeplans room display endpoint — pairing code setup and the events feed for a single resource. ## API Endpoints - [Overview](https://developer.makeplans.com/endpoints/): Overview of the Makeplans API endpoints — one endpoint per object, all over HTTPS. - [Slots](https://developer.makeplans.com/endpoints/slots/): API reference for the Makeplans slots endpoint — available times computed from resources, services and opening hours. - [Bookings](https://developer.makeplans.com/endpoints/bookings/): API reference for the Makeplans bookings endpoint — attributes, states and operations for managing bookings. - [People](https://developer.makeplans.com/endpoints/people/): API reference for the Makeplans people endpoint — customers, their unique fields and relations. - [Services](https://developer.makeplans.com/endpoints/services/): API reference for the Makeplans services endpoint — service types and their attributes. - [Events](https://developer.makeplans.com/endpoints/events/): API reference for the Makeplans events endpoint — fixed-time events such as classes and concerts, and their bookings. - [Resources](https://developer.makeplans.com/endpoints/resources/): API reference for the Makeplans resources endpoint — attributes and operations for managing bookable resources. - [Resource Exception Dates](https://developer.makeplans.com/endpoints/resource-exception-dates/): API reference for Makeplans resource exception dates — per-date opening hours overrides for resources. - [Providers](https://developer.makeplans.com/endpoints/providers/): API reference for the Makeplans providers endpoint — the link between resources and the services they provide. - [Categories](https://developer.makeplans.com/endpoints/categories/): API reference for the Makeplans categories endpoint — organise services in a category tree. - [Coupons](https://developer.makeplans.com/endpoints/coupons/): API reference for the Makeplans coupons endpoint — attributes and operations for managing coupons. - [Orders](https://developer.makeplans.com/endpoints/orders/): API reference for the Makeplans orders endpoint — attributes and operations for managing orders. - [Gift Cards](https://developer.makeplans.com/endpoints/gift-cards/): API reference for the Makeplans gift cards endpoint — attributes and operations for managing gift cards. - [Message Templates](https://developer.makeplans.com/endpoints/message-templates/): API reference for the Makeplans message templates endpoint — the content of booking confirmations, reminders and follow-ups. - [Webhooks endpoint](https://developer.makeplans.com/endpoints/webhooks/): API reference for the Makeplans webhooks endpoint — attributes and operations for managing webhook subscriptions. - [Account](https://developer.makeplans.com/endpoints/account/): API reference for the Makeplans account endpoint — information and settings for your account. ## Examples - [Examples](https://developer.makeplans.com/examples/overview/): Two ways of using the Makeplans API — the public API with JavaScript on your website, or the private API from your application. - [Public Booking Site](https://developer.makeplans.com/examples/public-booking-site/): Examples of building a public booking site with the Makeplans public API using JavaScript. - [Private API](https://developer.makeplans.com/examples/private-api/): Example requests and responses for the private Makeplans API. - [Webhooks examples](https://developer.makeplans.com/examples/webhooks/): Example webhook event payloads from the Makeplans API. ## Pages - [Changelog](https://developer.makeplans.com/changelog/): Changes and additions to the Makeplans API, newest first. - [Partner API](https://developer.makeplans.com/partner/): Create Makeplans accounts programmatically with the Partner API — for resellers and platform partners.