iMessage Node.js & TypeScript SDK

Install

One command to add the iMessage Node.js / TypeScript SDK to your project.

npm install @blooio/sdk
# or
pnpm add @blooio/sdk
# or
yarn add @blooio/sdk

Send your first iMessage

This is the smallest working example — authenticate with your Blooio API key, then call the send-message method on the client.

import { Blooio } from "@blooio/sdk";

const blooio = new Blooio({ apiKey: process.env.BLOOIO_API_KEY });

await blooio.chats.sendMessage({
  phone: "+15551234567",
  body: "Hey Alex — thanks for booking a demo. Reply with any questions.",
});

Handle inbound iMessages and webhooks

Every inbound iMessage, delivery, read, and reaction event is POSTed to your webhook URL. Use the SDK's signature verifier to reject forged requests and deserialize the payload into typed objects.

import express from "express";
import { Blooio, verifyWebhook } from "@blooio/sdk";

const app = express();

app.post(
  "/webhooks/blooio",
  express.raw({ type: "application/json" }),
  (req, res) => {
    const event = verifyWebhook({
      body: req.body,
      signature: req.header("x-blooio-signature") ?? "",
      secret: process.env.BLOOIO_WEBHOOK_SECRET,
    });

    if (event.type === "message.received") {
      console.log("Inbound iMessage:", event.data.body);
    }

    res.sendStatus(200);
  },
);

What the SDK gives you on top of raw REST

• 100% TypeScript — every endpoint, payload, and webhook event is typed
• Automatic retries with exponential backoff and jitter
• Works in Node 18+, Bun, Deno, and edge runtimes (Cloudflare Workers, Vercel Edge)
• Webhook signature verification — drop-in Express, Fastify, Hono, and Next.js helpers
• Streaming helpers for large inbound media downloads
• MIT-licensed and open source on GitHub

Node.js / TypeScript iMessage SDK FAQ