Getting Started
Learn how to integrate Amesio into your application.
Heads up
Overview
This guide walks you through the first steps.
Install
npm
terminalbash
$ npm install @amesio/sdk
$ npm install --save-dev @amesio/typespip
terminalbash
$ pip install amesio
$ pip install amesio[asyncio] # optionalAuthenticate
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!,
});Never ship keys to the client
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-callNext steps
- Set up
webhooksto receive booking events. - Read the
API referencefor every endpoint. - Configure
OAuth scopesfor end-user grants.