Documentation
Introduction
mdnt is iMessage infrastructure for developers. Send and receive iMessages programmatically, with your own Apple ID handle, through a single typed API.
What is mdnt
iMessage is a closed platform — Apple does not publish a developer API. mdnt operates a fleet of real Macs hosting customer-owned Apple IDs, and exposes them through a clean HTTP and SDK surface. You write code that looks like Twilio; we run the Macs that talk to Apple.
Every Apple ID belongs to exactly one customer. There is no shared pool, no allocation logic, no ambiguity about who sends from where. The handle agent@example.com is yours — same address, every message.
How it works
- You provision a handle (an Apple ID hosted on our fleet).
- You call
POST /v1/messageswithfrom,to, andtext. - The backend dispatches to the Mac hosting your handle, which drives Messages.app over a thin local bridge.
- Replies arrive at your webhook URL, deduped on Apple's stable GUIDs, signed with HMAC-SHA256.
Next steps
- Quickstart — send your first message in three minutes.
- Authentication — API tokens, scopes, and rotation.
- Messages API — the full reference.