Developers (API & Webhooks) Featured Article Updated July 18, 2026

Using The REST API v1

Build on Appntmnts with the REST API v1, authenticated by Bearer token or X-Api-Key.

All Articles Help Center
Article Developers (API & Webhooks)

The Appntmnts REST API v1 lets you read and manage your scheduling data programmatically, so you can build custom integrations, dashboards, and automations on top of your account.

Authentication

Requests are authenticated with your API key, sent either as a Bearer token in the Authorization header or in the X-Api-Key header. Keep your key secret and treat it like a password, since it grants access to your account data.

Core Endpoints

  • /me returns details about the authenticated account.
  • /event-types lists the event types you offer.
  • /availability exposes open time slots.
  • /bookings lets you read and manage bookings.

Getting Started

  1. Generate an API key from your developer settings.
  2. Send it in the Authorization or X-Api-Key header on each request.
  3. Call the endpoint you need and work with the JSON response.

To react to bookings in real time rather than polling, pair the API with webhooks.

Did This Answer Your Question?

Browse More Articles Contact Support