Documentation
Documentation

Getting Started

Learn how to integrate Amesio into your application.

Overview

This guide walks you through the first steps.

Install

npm

terminalbash
$ npm install @amesio/sdk
$ npm install --save-dev @amesio/types

pip

terminalbash
$ pip install amesio
$ pip install amesio[asyncio]  # optional

Authenticate

Pass your API key when constructing the client. The SDK reads AMESIO_API_KEY from the environment by default.

src/client.tstypescript
import { Amesio } from "@amesio/sdk";

export const amesio = new Amesio({
  apiKey: process.env.AMESIO_API_KEY!,
  org:    process.env.AMESIO_ORG_ID!,
});

First request

Create a booking page with a single call. The response includes a public URL you can share.

Request

src/quickstart.tstypescript
const page = await amesio.bookingPages.create({
  slug: "intro-call",
  title: "30-minute intro",
  duration_minutes: 30,
});

Response

src/quickstart.tstypescript
console.log(page.public_url);
// → https://amesio.com/sara/intro-call

Next steps

  • Set up webhooks to receive booking events.
  • Read the API reference for every endpoint.
  • Configure OAuth scopes for end-user grants.