SDKs - ApyConnect

Official, dependency-light SDKs wrap authentication, the response envelopes, typed errors, cursor pagination, and idempotency so you can focus on your integration. Each is a single file — drop it into your project.

TypeScript / JavaScript

Node 18+ or browser. Zero dependencies (uses the global fetch).

Python

Python 3.8+. Requires requests.

TypeScript / JavaScript

import { ApyConnect } from "./apyconnect";

const api = new ApyConnect({ clientId: "...", clientSecret: "..." });

// Create a contact (idempotent retry-safe with a key)
const contact = await api.contacts.create(
  { name: "Ada Lovelace", email: "ada@example.com" },
  "signup-2026-01-31-ada",
);

// Iterate every page transparently
for await (const c of api.contacts.list({ tag: "vip" })) {
  console.log(c.id);
}

// Send a channel-agnostic message
await api.messages.create({
  to: { channel_id: "chan_...", identifier: { type: "phone", value: "+13035551234" } },
  content: { type: "text", text: "Hi from the API" },
});

Python

from apyconnect import ApyConnect

api = ApyConnect(client_id="...", client_secret="...")

contact = api.contacts.create(
    {"name": "Ada Lovelace", "email": "ada@example.com"},
    idempotency_key="signup-2026-01-31-ada",
)

for c in api.contacts.list(tag="vip"):
    print(c["id"])

api.messages.create({
    "to": {"channel_id": "chan_...", "identifier": {"type": "phone", "value": "+13035551234"}},
    "content": {"type": "text", "text": "Hi from the API"},
})

What the SDKs handle for you

Auth: fetches and caches an OAuth2 client_credentials token, refreshing it before expiry.
Envelopes: request() returns the unwrapped data; list() yields items across every page.
Errors: any non-2xx raises a typed ApyError with type, code, message, and trace_id.
Idempotency: pass a key to create() to make retries safe.

Prefer another language? Every endpoint is described in the OpenAPI spec, which you can feed to your generator of choice.