SDKs

Official Node.js and Python client examples

Official clients wrap the REST API with resource methods, organization scoping, structured errors, and safe retries. Choose a language, then an example.

pnpm add @ecowave/node

TypeScript

import { EcoWave } from "@ecowave/node";

const client = new EcoWave({
  apiKey: process.env.ECOWAVE_API_KEY!,
  organizationId: process.env.ECOWAVE_ORG_ID!,
});

const message = await client.messages.send({
  to: "+251911234567",
  text: "Your verification code is 482913.",
  idempotencyKey: "otp-user-42-20260808",
});

console.log(message.id, message.status);

responseJSON

{
  "id": "7f8d9e1a-4b2c-4d5e-9f01-234567890abc",
  "status": "queued",
  "to": "+251911234567",
  "segments": 1,
  "createdAt": "2026-08-08T09:12:04.000Z"
}

Reads retry on transient 5xx. Sends retry only when an idempotency key makes replay safe.