Developers

Build with OLISE

REST API, webhooks and a typed TypeScript SDK to embed OLISE’s phone-operator into your CRM, your booking flow, or your operations stack.

OpenAPI 3.1 spec API status

cURL

curl -sS https://olise.ai/api/public/v1/contacts \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: olise_live_…' \
  -d '{"phone":"+13055551212","name":"Jane Doe"}'

Node

import { OliseClient } from '@olise/sdk'

const olise = new OliseClient(process.env.OLISE_API_KEY!)
const contact = await olise.contacts.create({
  phone: '+13055551212',
  name: 'Jane Doe',
})

Python

import os, requests

r = requests.post(
    "https://olise.ai/api/public/v1/contacts",
    headers={"X-API-Key": os.environ["OLISE_API_KEY"]},
    json={"phone": "+13055551212", "name": "Jane Doe"},
)
print(r.json())

Authentication

Every request requires an X-API-Key header. Generate API keys from Dashboard → Settings → API keys. Keys are scoped (read / write) and never leave the server.

Create a key with the minimum scope you need.
Store it in your environment as OLISE_API_KEY.
Send it with every request — never expose it client-side.

Rate limits

Per-key limits. Each response includes X-RateLimit-Limit,X-RateLimit-Remaining andX-RateLimit-Reset.

Plan	Burst	Monthly
Starter	10 req/s	50,000 / mo
Professional	50 req/s	500,000 / mo
Enterprise	Custom	Custom

Webhooks

Subscribe to events such as call.completed,reservation.created,contact.updated. Payloads are signed with HMAC-SHA-256 in X-Olise-Signature.

Full event catalog in the OpenAPI spec.

Endpoints

Base URL: https://olise.ai/api/public

GET/v1/contactsList contacts (cursor paginated)
POST/v1/contactsUpsert contact by phone (idempotent)
GET/v1/contacts/:idRetrieve a single contact
PATCH/v1/contacts/:idUpdate fields
GET/v1/callsList calls with filters (intent, time)
GET/v1/calls/:idRetrieve a call (transcript redacted)
GET/v1/reservationsList reservations
POST/v1/reservationsCreate a reservation
GET/v1/reservations/:idRetrieve a reservation
PATCH/v1/reservations/:idUpdate / cancel a reservation
POST/v1/outboundTrigger an outbound call (Pro+)
GET/v1/usageCurrent-period usage and cost

Official SDKs

Typed clients for your stack

TypeScript

@olise/sdk

First-party. Tree-shakable. Edge-runtime compatible.

Coming Q3 2026

Python

olise-python

Sync + async. Type hints. Pydantic models.

Coming Q4 2026

Postman

postman_collection.json

Import once, explore every endpoint.

Download