Skip to main content
Messages.dev is the iMessage API for agents. Send and receive messages, reactions, typing indicators, and read receipts over a simple REST API or TypeScript SDK.

Send messages

Send iMessages to any phone number or Apple ID with a single API call.

Receive messages

Get notified instantly via webhooks when new messages arrive.

Reactions

Send and receive iMessage reactions (love, like, laugh, etc.).

Typing & read receipts

Send typing indicators and mark conversations as read.

​
How it works

  1. Sign up at app.messages.dev and create an API key
  2. Activate your sandbox: text an activation code to the sandbox number to pair your phone
  3. Send messages, reactions, and typing indicators via the REST API or TypeScript SDK
  4. Receive incoming messages and events in real time via webhooks
import { createClient } from "@messages-dev/sdk";

const client = createClient();

await client.sendMessage({
  from: "+15551234567",
  to: "+15559876543",
  text: "Hello from Messages.dev!",
});

{
  "event": "message.received",
  "data": {
    "id": "msg_abc123",
    "sender": "+15559876543",
    "text": "Hey, got your message!",
    "sent_at": 1710000005000
  }
}

​
Key concepts

ConceptDescription
LinesYour iMessage phone numbers or Apple IDs. Each line is a separate iMessage account.
ChatsConversations on a line, identified by the recipient’s phone number or Apple ID.
WebhooksHTTPS callbacks that notify your server when events happen (new message, delivery confirmation, etc.).
API keysBearer tokens you create in the dashboard. Keys have configurable scopes and optional line restrictions.

​
Get started

Quickstart

Send your first message in 5 minutes

TypeScript SDK

Install the client library

API Reference

Explore all endpoints