Developers

Build with the oToK API

A full REST API for everything your workspace does — plus official SDKs for Node.js and Python, hosted docs, a complete Redoc reference and an interactive Swagger.

Read the docsAPI reference

REST API access is included on Growth and up.

One API for the whole platform

Everything lives under /v1 and is scoped to the workspace your API key was created in.

Contacts & notes

Create, upsert, tag and annotate contacts.

Campaigns & templates

Create WhatsApp campaigns and send approved templates.

Deals & pipelines

Manage deals, move stages and mark won or lost.

Payments

Record payments, mint hosted pay links and pull a contact's invoices and receipts.

Transactional emails

Send transactional email through your verified sending domain.

Webhooks

Receive delivery, engagement, order and payment events on your own endpoints.

Bookings & meeting types

Read and create bookings and manage meeting types.

Events & attendance

Create or update events, register attendees and read who's coming.

Tags & contact groups

Organize your audience with tags and contact groups.

Official SDKs

Typed, zero-dependency clients for Node.js and Python — or call the REST API directly from anything that speaks HTTP.

Node.js

@otok/node — Node 18+, TypeScript types, zero dependencies.

npm install @otok/node
Create or update a contact
import { OtokClient } from "@otok/node";
const otok = new OtokClient({ apiKey: process.env.OTOK_API_KEY });
const contact = await otok.contacts.upsert({
  email: "[email protected]",
  phone: "+12025551234",
  first_name: "Jane",
  tags: ["VIP", "Newsletter"],
});

Python

otok on PyPI — Python 3.9+, typed, zero dependencies.

pip install otok
Create or update a contact
import os
from otok import OtokClient
client = OtokClient(api_key=os.environ["OTOK_API_KEY"])
contact = client.contacts.upsert({"email": "[email protected]", "tags": ["VIP"]})
Or plain curl
curl https://app.otok.io/api/v1/contacts -H "Authorization: Bearer otok_live_..."

Authentication uses workspace API keys (otok_live_…), created in the app under Settings → Developers. The base URL is https://app.otok.io/api/v1.

AI assistants connect through the MCP connector: sign in, choose the workspaces to connect and how long access lasts, then approve the connection without copying a token. The assistant acts within your permissions and shows you what it intends to change for confirmation. Manage or revoke the connection under Settings → AI Agents. Included on Growth and up.

Docs, reference and source

Developer docs Hosted guides for every part of the API.
API reference Every endpoint, parameter and schema — Redoc, generated from the OpenAPI spec.
GitHub The public otok-api repository: SDKs, examples and integrations.
Interactive Swagger Try requests live against your own workspace.

oToK for WooCommerce

Our WordPress plugin connects a WooCommerce store to oToK — marketing consent at checkout, customers synced as contacts, orders recorded as revenue and abandoned-cart recovery.

See the WooCommerce plugin

Ready to upgrade your customer communication?

Get started with oToK — connecting a WhatsApp number takes minutes.

Get started freeTalk to us

No credit card required — start right away