Apple's position
What is Apple's iMessage API?
Apple has no iMessage API in the sense developers mean. It publishes the Messages framework for building iMessage apps, MessageUI for pre-filling a compose sheet the user sends, SiriKit intents for your own messaging service, and Apple Messages for Business for customer-initiated conversations. None of them send an iMessage to an arbitrary number from your server.
What each one really does
- Messages framework —
MSMessagesAppViewController,MSMessage,MSSticker. Builds the apps in the drawer above the keyboard.MSConversation.insert(_:)puts content in the compose field; the user still taps send. This is the single most misread method in Apple's messaging docs. - MessageUI —
MFMessageComposeViewControllerpresents the system compose sheet with recipients pre-filled. Your app cannot dismiss it, send it, or read what the user changed. - SiriKit —
INSendMessageIntentlets Siri send through *your* app. A hook into your service, not into Apple's. - Messages for Business — a genuine REST API, officially sanctioned, and inbound-only. Full guide.
The pattern
Every framework keeps a human or a prior customer action in the loop. Consistency at that level is a policy, not an oversight — and it is why searching Apple's developer site for the endpoint you want will never find it.
The complete breakdown of each framework, and what to use instead if you need to send first.
Things people assume exist, and do not
| Assumption | Reality |
|---|---|
| An entitlement you can request | No such entitlement exists in the developer portal |
| A partner tier with private access | No. Even large CPaaS vendors have none |
| An enterprise agreement that unlocks it | No. Enterprise programmes cover internal distribution, not iMessage |
| A private API used by approved vendors | No. Third-party providers run Apple devices and accounts themselves |
| It is coming soon | No public signal. Apple adopted RCS instead, which is telling |
What you can officially build
- An iMessage app — rich interactive content inside a conversation the user already has open. Genuinely good for what it does.
- A compose-sheet integration that pre-fills a message the user sends themselves.
- Messages for Business, through an approved CSP, for inbound customer conversations. What that involves.
If you need to send first
There is no official route, and no amount of searching the developer site will produce one. Your options are a third-party provider that operates outside Apple's terms, or a different channel. Both are legitimate choices; pretending the first is sanctioned is not. The honest framing.
Pick by what you need to do
| You need to | Build against | Caveat |
|---|---|---|
| Send to any number from a server | A third-party REST provider | Unofficial; per-line pricing |
| Respond to inbound customer messages | Messages for Business | Official; weeks to onboard |
| Put rich UI in a thread the user has open | Apple's Messages framework | User taps send |
| Automate your own machine | AppleScript or Shortcuts | No delivery signal, personal Apple ID |
| Run it yourself on your own Mac | BlueBubbles or a Matrix bridge | Your uptime, your Apple ID |
Do you need an SDK?
Almost certainly not. Third-party providers expose small REST APIs — send, status, webhook — and a hand-written client is about forty lines with no supply chain attached. Check any provider SDK's last publish date before depending on it; a package quiet for two years is common here and is a warning rather than a sign of stability.
Working Node.js client, Python client, and the developer hub.
This page also answers
- official apple imessage api for developers
- imessage developer api
Further reading
Go deeper
Apple's real Messages APIs
Apple publishes a lot of Messages documentation. None of it lets you send an iMessage to a phone number from a server. Here is what each framework really does.
9 min readStrategyThe iMessage bot API question
Apple has never shipped a bot API for iMessage, and shows no sign of doing so. What that rules out, what it leaves open, and how conversational products actually reach the blue bubble.
9 min readStrategyWhat is an iMessage API?
What these services actually are, how they send a blue bubble without Apple's involvement, what you get for the money, and what you are trusting when you buy one.
7 min read