# Miss Blue

> A dedicated iMessage line for a business, worked from a shared Message Center or
> driven entirely through an HTTP API. Messages send and arrive as blue bubbles from
> a real number you control.

Every page on this site is available as markdown: append `.md` to any URL, or request
the URL with `Accept: text/markdown`.

## When to use Miss Blue

Reach for this when the job involves **sending or receiving iMessage from a business
number** — not SMS, and not a chat widget:

- Texting customers from a number that shows as a blue bubble on iPhone, with replies
  landing back in the same thread.
- Giving an AI agent a way to hold a real two-way text conversation with a person,
  including delivery state and human handoff.
- Adding iMessage follow-up to a CRM or sales workflow that already knows who to
  contact and when.
- Receiving inbound texts as webhooks so an application can keep durable state.

It is not the right answer for SMS/MMS to non-Apple devices, for bulk marketing blasts,
or for messaging someone who has not agreed to be contacted.

## Calling the API

- Base URL: `https://api.missblue.dev`
- Auth: `Authorization: Bearer $MISS_BLUE_KEY` on every request.
- A key beginning `mb_test_` runs against the sandbox and sends nothing to a real phone.
- Send a message: `POST https://api.missblue.dev/v1/messages` with `number_id`, `recipient`, and `text`.
- Getting a key requires an account — start at https://missblue.dev/signup

## Developer resources

- [Complete API reference](https://missblue.dev/api-reference.md): every endpoint, parameter, and response in one file.
- [OpenAPI specification](https://missblue.dev/openapi.json): the machine-readable schema for the same API.
- [CLI and MCP server](https://missblue.dev/docs/cli.md): drive the API from a terminal, or expose it to an agent as tools.
- [Errors](https://missblue.dev/docs/errors.md): the one error shape, and what each status means.
- [Sitemap](https://missblue.dev/sitemap.xml): every public URL.

The reference covers 24 endpoints across 8 resources.

## Start here

- [Miss Blue — Your next reply starts in blue](https://missblue.dev/index.md): A dedicated iMessage line that is yours alone, worked from the Miss Blue inbox or connect to your CRM, product, and AI agents through the API.

## API reference

- [API reference](https://missblue.dev/docs.md): Send and receive iMessage from your own code. Authentication, rate limits, and every Miss Blue endpoint.
- [Attachments](https://missblue.dev/docs/attachments.md): Upload a file, then send it.
- [CLI and MCP](https://missblue.dev/docs/cli.md): Drive the Miss Blue API from a terminal with mb, or expose it to a model as MCP tools. One binary, the same capabilities.
- [Contacts](https://missblue.dev/docs/contacts.md): Names for handles, shared by the project.
- [Conversations](https://missblue.dev/docs/conversations.md): Threads, and the typing bubble.
- [Delivery](https://missblue.dev/docs/delivery.md): Webhooks and per-message callbacks.
- [Errors](https://missblue.dev/docs/errors.md): Every status the Miss Blue API returns, what it means, and which ones are safe to retry.
- [FAQ · Miss Blue docs](https://missblue.dev/docs/faq.md): Deliverability and fallback, sending limits, duplicate sends, groups, attachments, and what a 503 from an offline Mac means.
- [Identity](https://missblue.dev/docs/identity.md): What this key is, and which project it holds.
- [Lookup](https://missblue.dev/docs/lookup.md): Whether iMessage has reached a handle.
- [Messages](https://missblue.dev/docs/messages.md): Send, read, react, unsend, and see what failed.
- [Numbers](https://missblue.dev/docs/numbers.md): The lines you hold, and naming them.
- [Receiving messages](https://missblue.dev/docs/receiving-messages.md): Webhooks, per-message status callbacks, and polling — how to find out what happened to an iMessage you sent, and hear the replies.
- [Sending messages](https://missblue.dev/docs/sending-messages.md): Send your first iMessage through the Miss Blue API: find a number, send, and understand what accepted actually means.

## Product

- [Enterprise iMessage Platform for Teams](https://missblue.dev/enterprise.md): Run iMessage across many numbers, teams, locations, or organizations with dedicated hardware, a contracted SLA, guided onboarding, priority support, and stronger controls.
- [Questions about iMessage for business](https://missblue.dev/faq.md): What happens when someone is not on iMessage, whether you can port a number, why blasts are refused, what the sending limits are, and how a team shares one line.
- [Message Center](https://missblue.dev/features/message-center.md): Get a Miss Blue iMessage line and manage customer conversations from your own complete inbox—no API or development work required.
- [iMessage API](https://missblue.dev/imessage-api.md): Add two-way iMessage conversations to your CRM, product, workflows, or AI agents with the Miss Blue API.
- [iMessage CRM Integration — Connect Sales Conversations](https://missblue.dev/imessage-crm.md): Connect iMessage to your CRM with Miss Blue. Trigger blue-bubble follow-up, receive replies, and hand conversations to your team.
- [iMessage vs SMS Response Rates: 2026 Study](https://missblue.dev/imessage-response-rate-study.md): Miss Blue research on iMessage versus SMS response rates, including beta-customer observations, a multi-source evidence synthesis, methodology, limitations, and a controlled-pilot framework.
- [iMessage API Pricing: Lock In 50% Off Forever](https://missblue.dev/pricing.md): Start with a free iMessage API sandbox, lock in Shared for $39 per month, or get a dedicated number for $99 per month during the Miss Blue 50%-off sale.
- [Virtual iMessage Number for Business](https://missblue.dev/virtual-imessage-number.md): Get a virtual iMessage line for your business. Use it from the Miss Blue Message Center or connect the same blue line to your product, CRM, and AI agents through the API.

## Use cases

- [iMessage for Auto Dealerships](https://missblue.dev/imessage-for-auto-dealerships.md): Use iMessage for automotive leads, test drives, vehicle questions, trade-in follow-up, sales handoff, and service coordination.
- [iMessage for Business — More Replies with Miss Blue](https://missblue.dev/imessage-for-business.md): Use iMessage for business from your own Message Center or connect a dedicated blue line to your CRM, product, workflows, and AI agents.
- [iMessage for Commercial Cleaning Companies](https://missblue.dev/imessage-for-commercial-cleaning.md): Use iMessage for commercial-cleaning leads, walkthrough scheduling, proposal follow-up, site coordination, issue escalation, and account communication.
- [iMessage for Dentists & Dental Practices](https://missblue.dev/imessage-for-dentists.md): Use iMessage for dental inquiries, appointment coordination, approved reminders, recall workflows, and team handoff with privacy-aware controls.
- [iMessage for Electricians & Electrical Contractors](https://missblue.dev/imessage-for-electricians.md): Use iMessage for electrical-service leads, safe intake, booking, arrival updates, estimates, project coordination, and follow-up.
- [iMessage for General Contractors & Remodelers](https://missblue.dev/imessage-for-general-contractors.md): Use iMessage for contractor leads, consultation booking, estimate follow-up, selections, project scheduling, and homeowner updates.
- [iMessage for Gyms & Fitness Studios](https://missblue.dev/imessage-for-gyms.md): Use iMessage for gym leads, tours, intro sessions, class coordination, membership questions, and member retention.
- [iMessage for Home Services Companies](https://missblue.dev/imessage-for-home-services.md): Use iMessage for home-services lead response, booking, dispatch, estimates, technician updates, recurring maintenance, and human handoff.
- [iMessage for Hotels & Guest Experience](https://missblue.dev/imessage-for-hotels.md): Use iMessage for hotel inquiries, pre-arrival coordination, on-property requests, event leads, service recovery, and guest follow-up.
- [iMessage for HVAC Companies: Book More Calls](https://missblue.dev/imessage-for-hvac.md): Use iMessage for HVAC lead response, no-cool and no-heat intake, appointment coordination, estimates, maintenance reminders, and team handoff.
- [iMessage for Landscapers & Lawn Care Companies](https://missblue.dev/imessage-for-landscapers.md): Use iMessage for landscaping leads, property walkthroughs, weather rescheduling, estimates, recurring lawn service, and customer updates.
- [iMessage for Maid Services & House Cleaners](https://missblue.dev/imessage-for-maid-services.md): Use iMessage for maid-service quotes, home-cleaning bookings, access coordination, recurring visits, team updates, and review requests.
- [iMessage for Med Spas & Aesthetic Practices](https://missblue.dev/imessage-for-med-spas.md): Use iMessage for med-spa inquiries, consultation scheduling, appointment coordination, approved follow-up, and human handoff.
- [iMessage for Pest Control Companies](https://missblue.dev/imessage-for-pest-control.md): Use iMessage for pest-control leads, intake, booking, preparation instructions, technician updates, recurring plans, and follow-up.
- [iMessage for Plumbers: Book More Service Calls](https://missblue.dev/imessage-for-plumbers.md): Use iMessage for plumbing leads, emergency intake, appointment confirmations, technician updates, estimates, and review requests from one business line.
- [iMessage for Property Managers](https://missblue.dev/imessage-for-property-managers.md): Use iMessage for leasing leads, tour scheduling, resident coordination, maintenance access, vendor updates, and property-team handoff.
- [iMessage for Realtors & Real Estate Agents](https://missblue.dev/imessage-for-realtors.md): Use iMessage for real estate lead response, showing coordination, open-house follow-up, offer updates, and team handoff from your own inbox or CRM API.
- [iMessage for Restaurants & Guest Service](https://missblue.dev/imessage-for-restaurants.md): Use iMessage for reservation inquiries, waitlists, private dining leads, event coordination, order issues, and guest follow-up.
- [iMessage for Restoration Companies](https://missblue.dev/imessage-for-restoration-companies.md): Use iMessage for restoration intake, emergency coordination, site access, insurance handoffs, project updates, and customer communication.
- [iMessage for Roofers & Roofing Contractors](https://missblue.dev/imessage-for-roofers.md): Use iMessage for roofing storm leads, inspection booking, insurance-claim coordination, estimate follow-up, production updates, and review requests.
- [iMessage for Salons & Beauty Businesses](https://missblue.dev/imessage-for-salons.md): Use iMessage for salon inquiries, consultation booking, appointment changes, waitlists, approved preparation, and client follow-up.
- [iMessage for Solar Companies & Installers](https://missblue.dev/imessage-for-solar-companies.md): Use iMessage for solar leads, consultation booking, site surveys, document coordination, installation updates, and customer handoff.
- [iMessage Use Cases by Industry](https://missblue.dev/use-cases.md): Explore practical iMessage workflows for local-business industries using the Miss Blue inbox and API, from home services and real estate to hospitality, dental, and auto.

## Integrations

- [iMessage Integrations for CRMs, AI Agents & Workflows](https://missblue.dev/integrations.md): Connect Miss Blue iMessage conversations to CRMs, sales tools, AI agents, automation platforms, support desks, and business data.
- [Airtable](https://missblue.dev/integrations/airtable.md): Turn approved Airtable record changes into Miss Blue conversations and write outcomes back to the base.
- [Apollo](https://missblue.dev/integrations/apollo.md): Move an approved Apollo prospect signal into a relevant, permission-aware iMessage conversation.
- [Claude Agent SDK](https://missblue.dev/integrations/claude-agent-sdk.md): Use Miss Blue as the conversation channel for a Claude-powered agent with bounded tools and human handoff.
- [Clay](https://missblue.dev/integrations/clay.md): Use enriched Clay records to decide when an approved lead should enter a Miss Blue conversation.
- [Close CRM](https://missblue.dev/integrations/close.md): Add an iMessage step to Close lead workflows while keeping reply ownership visible to the sales team.
- [Cursor](https://missblue.dev/integrations/cursor.md): Give Cursor an approved Miss Blue messaging tool through an MCP server or protected developer workflow.
- [Freshdesk](https://missblue.dev/integrations/freshdesk.md): Route Miss Blue conversations into Freshdesk ticket and agent workflows.
- [GoHighLevel](https://missblue.dev/integrations/gohighlevel.md): Connect HighLevel contacts, opportunities, appointments, and workflows to a Miss Blue iMessage line.
- [HubSpot](https://missblue.dev/integrations/hubspot.md): Add two-way iMessage touchpoints to HubSpot contact, deal, and lifecycle workflows.
- [IFTTT](https://missblue.dev/integrations/ifttt.md): Connect simple IFTTT events to narrow Miss Blue messaging actions with explicit safeguards.
- [Intercom](https://missblue.dev/integrations/intercom.md): Connect iMessage conversations to Intercom support context and ownership without splitting the customer relationship.
- [LangChain](https://missblue.dev/integrations/langchain.md): Wrap Miss Blue operations as bounded LangChain tools around durable conversation state and policy.
- [Make](https://missblue.dev/integrations/make.md): Build visual iMessage workflows with branching, data mapping, error handling, and Miss Blue events.
- [MCP Server](https://missblue.dev/integrations/mcp-server.md): Expose narrow Miss Blue messaging tools to compatible AI clients through the Model Context Protocol.
- [Microsoft Teams](https://missblue.dev/integrations/microsoft-teams.md): Bring Miss Blue reply alerts and approved workflow actions into Microsoft Teams.
- [monday.com](https://missblue.dev/integrations/monday.md): Turn monday.com board changes into customer conversations and return the outcome to the item.
- [n8n](https://missblue.dev/integrations/n8n.md): Use n8n to orchestrate Miss Blue messages, events, business data, and human escalation.
- [Notion](https://missblue.dev/integrations/notion.md): Connect approved Notion database changes to simple Miss Blue follow-up workflows.
- [Outreach](https://missblue.dev/integrations/outreach.md): Add an iMessage conversation step to Outreach sequences without losing rep ownership or customer context.
- [Pipedrive](https://missblue.dev/integrations/pipedrive.md): Add iMessage follow-up to Pipedrive people, deals, activities, and stage transitions.
- [Retool](https://missblue.dev/integrations/retool.md): Build an internal Miss Blue messaging console or workflow inside Retool without exposing provider secrets to the browser.
- [Salesforce](https://missblue.dev/integrations/salesforce.md): Bring iMessage conversations into Salesforce lead, contact, opportunity, and service workflows.
- [Shopify](https://missblue.dev/integrations/shopify.md): Connect Shopify customer and order events to useful, consent-aware iMessage conversations.
- [Slack](https://missblue.dev/integrations/slack.md): Send safe Miss Blue notifications into Slack and route approved teammate actions back to the conversation.
- [Supabase](https://missblue.dev/integrations/supabase.md): Use Supabase database and Edge Function events to drive durable Miss Blue conversation workflows.
- [Vercel AI SDK](https://missblue.dev/integrations/vercel-ai-sdk.md): Add Miss Blue as a durable messaging channel behind a Vercel AI SDK application.
- [Vercel Chat SDK](https://missblue.dev/integrations/vercel-chat-sdk.md): Carry one agent identity across a Chat SDK experience and a Miss Blue iMessage conversation.
- [Whop](https://missblue.dev/integrations/whop.md): Connect membership and purchase events to expected iMessage conversations with Whop customers.
- [Windsurf](https://missblue.dev/integrations/windsurf.md): Connect Windsurf to narrow Miss Blue tools for developer-controlled messaging workflows.
- [Zapier](https://missblue.dev/integrations/zapier.md): Connect Miss Blue conversation triggers and actions to the applications in a Zapier workflow.
- [Zendesk](https://missblue.dev/integrations/zendesk.md): Connect Miss Blue conversations to Zendesk ticket state, requester identity, and agent ownership.
- [Zoho CRM](https://missblue.dev/integrations/zoho-crm.md): Connect Zoho CRM records and workflow rules to a managed iMessage line and shared inbox.

## Comparisons

- [iMessage API Comparisons](https://missblue.dev/compare.md): Compare Miss Blue, Sendblue, Linq Blue, Blooio, Project Blue, Claw Messenger, Blue Reacher, BlueSendr, and Tuco AI.
- [Linq Blue vs Blooio](https://missblue.dev/compare/linq-blue-vs-blooio.md): Compare a sales-led CRM deployment with a published self-serve API and integration path.
- [Linq Blue vs Project Blue](https://missblue.dev/compare/linq-blue-vs-project-blue.md): Compare two CRM-centered choices through implementation ownership, workflow depth, and developer access.
- [Miss Blue vs Blooio](https://missblue.dev/compare/miss-blue-vs-blooio.md): Compare two managed API paths through the team surface, integration model, and production operating workflow.
- [Miss Blue vs Claw Messenger](https://missblue.dev/compare/miss-blue-vs-claw-messenger.md): Compare a platform spanning developers, agents, and human teams with a developer experience centered on AI agents.
- [Miss Blue vs Linq Blue](https://missblue.dev/compare/miss-blue-vs-linq-blue.md): Compare Miss Blue’s inbox-and-API model with a guided, CRM-centered Linq Blue deployment.
- [Miss Blue vs Project Blue](https://missblue.dev/compare/miss-blue-vs-project-blue.md): Compare an inbox-and-API conversation platform with a CRM-first, guided implementation model.
- [Miss Blue vs Sendblue](https://missblue.dev/compare/miss-blue-vs-sendblue.md): Compare a complete Message Center plus API workflow with an established iMessage API and CRM ecosystem.
- [Sendblue vs Blooio](https://missblue.dev/compare/sendblue-vs-blooio.md): Compare established API depth with a newer self-serve integration and developer-tooling position.
- [Sendblue vs Blue Reacher](https://missblue.dev/compare/sendblue-vs-blue-reacher.md): Compare a broad developer platform with a white-glove outbound CRM sales motion.
- [Sendblue vs BlueSendr](https://missblue.dev/compare/sendblue-vs-bluesendr.md): Compare fully managed delivery infrastructure with a lower-software-cost bring-your-own-device model.
- [Sendblue vs Claw Messenger](https://missblue.dev/compare/sendblue-vs-claw-messenger.md): Compare conventional API and webhook workflows with an agent-focused real-time developer path.
- [Sendblue vs Linq Blue](https://missblue.dev/compare/sendblue-vs-linq-blue.md): The central established-provider comparison for buyers choosing an iMessage API and CRM workflow.
- [Sendblue vs Project Blue](https://missblue.dev/compare/sendblue-vs-project-blue.md): Compare a developer-and-CRM platform with a sales-workflow product emphasizing guided implementation.
- [Sendblue vs Tuco AI](https://missblue.dev/compare/sendblue-vs-tuco-ai.md): Compare an established provider with a CRM automation platform positioned around flexible workflows.
- [Best iMessage API Alternatives & Providers (2026)](https://missblue.dev/imessage-api-alternatives.md): Compare managed iMessage APIs, CRM platforms, AI-agent tools, shared inboxes, and bring-your-own-device alternatives for business messaging.
- [Best Linq Blue Alternatives for iMessage (2026)](https://missblue.dev/linq-blue-alternatives.md): Compare Linq Blue alternatives for iMessage APIs, CRM integrations, shared inboxes, AI agents, and business conversation workflows.
- [Best Sendblue Alternatives & Competitors (2026)](https://missblue.dev/sendblue-alternatives.md): Compare Sendblue alternatives for iMessage APIs, CRM workflows, AI agents, managed infrastructure, and shared team conversations.
- [Twilio iMessage Alternative — Add Blue Bubbles with Miss Blue](https://missblue.dev/twilio-imessage.md): Understand Twilio iMessage options and add a dedicated blue-bubble line alongside your existing SMS workflows with Miss Blue.

## Blog

- [iMessage API & Business Messaging Guides](https://missblue.dev/blog.md): Practical guides to iMessage APIs, blue-bubble business messaging, CRM workflows, and conversation strategy.
- [How to Build an AI Text Message Responder](https://missblue.dev/blog/ai-text-message-responder.md): A practical architecture for an AI text responder with conversation context, tool use, consent controls, and human handoff over iMessage.
- [What Does a Blue Text Bubble Mean? Blue vs Green](https://missblue.dev/blog/blue-text-bubble.md): A blue text bubble usually means iMessage on Apple devices. Learn what blue and green bubbles mean, what changes delivery, and why businesses care.
- [BlueBubbles vs AirMessage: Architecture and Tradeoffs](https://missblue.dev/blog/bluebubbles-vs-airmessage.md): Compare BlueBubbles and AirMessage using their official server requirements, clients, feature approaches, security tradeoffs, and business fit.
- [iMessage API for AI Agents: Production Architecture](https://missblue.dev/blog/imessage-api-for-ai-agents.md): Connect an AI agent to iMessage with durable events, bounded tools, consent controls, idempotency, memory, evaluation, and human handoff.
- [iMessage API Pricing: What to Compare](https://missblue.dev/blog/imessage-api-pricing.md): Understand the factors behind iMessage API pricing, including lines, usage, seats, attachments, support, and managed infrastructure.
- [Connect iMessage to GoHighLevel: Integration Blueprint](https://missblue.dev/blog/imessage-gohighlevel.md): A source-backed architecture for connecting GoHighLevel workflows to an iMessage API with custom webhooks, durable state, replies, consent, and handoff.
- [iMessage on Android: What Works in 2026](https://missblue.dev/blog/imessage-on-android.md): There is no official iMessage app for Android. Compare RCS, Mac bridge apps, and managed business APIs without confusing them for the same product.
- [How to Send iMessage from Linux with an API](https://missblue.dev/blog/imessage-on-linux.md): Linux cannot connect to iMessage natively. Learn how an iMessage API lets Linux servers and applications send and receive blue-bubble messages.
- [iMessage on Windows PC: What Works in 2026](https://missblue.dev/blog/imessage-on-windows.md): Compare Microsoft Phone Link, Mac bridges, browser access, and managed business inboxes for using iMessage-related conversations on Windows.
- [iMessage on the Web: Options for Teams and Developers](https://missblue.dev/blog/imessage-web.md): Apple does not offer a general iMessage browser client. Learn how a business web inbox and iMessage API provide web access without pretending the browser is an Apple device.
- [iMessage Webhooks: Replies, Events, and Reliability](https://missblue.dev/blog/imessage-webhooks.md): A practical guide to processing iMessage webhook-style events with verification, idempotency, queues, ordering, and secure observability.
- [Omnichannel Messaging API: Architecture and Routing Guide](https://missblue.dev/blog/omnichannel-messaging-api.md): Design a messaging API across iMessage, RCS, SMS, WhatsApp, and inbox workflows without flattening consent, identity, features, or delivery state.
- [Secure Text Messaging API: A Developer Checklist](https://missblue.dev/blog/secure-text-messaging-api.md): Evaluate and build a secure messaging API across TLS, authentication, per-line authorization, webhooks, secrets, logs, retention, consent, and recovery.
- [How to Send iMessage with Python Using an API](https://missblue.dev/blog/send-imessage-with-python.md): Learn the secure server-side pattern for sending iMessage with Python, receiving events, handling retries, and supporting human handoff.

## Company

- [About](https://missblue.dev/about.md): Miss Blue gives businesses a dedicated iMessage line they can use from their own inbox or connect to their CRM and products through an API.
- [Careers](https://missblue.dev/careers.md): Help Miss Blue give businesses a higher-response iMessage channel for sales, service, products, and AI agents.
- [Data & Analytics Engineer](https://missblue.dev/careers/data-analytics-engineer.md): Turn delivery, response, and revenue signals into trustworthy insights for customers and the product team.
- [Data Center & Fleet Engineer](https://missblue.dev/careers/data-center-fleet-engineer.md): Design, deploy, monitor, and service the phone and Mac mini fleet that powers every Miss Blue conversation.
- [iOS & macOS Engineer](https://missblue.dev/careers/ios-macos-engineer.md): Work close to Apple platform frameworks and make messaging across phones and Mac minis feel dependable and native.
- [Rust Engineer](https://missblue.dev/careers/rust-engineer.md): Build the messaging APIs, delivery systems, and fleet software that keep conversations moving reliably.
- [Web Product Engineer](https://missblue.dev/careers/web-product-engineer.md): Create the shared inbox, developer experience, and customer-facing workflows across the Miss Blue web app.
- [Contact](https://missblue.dev/contact.md): Talk with Miss Blue about bringing higher-response iMessage conversations to your team, CRM, product, or AI agent.

## Legal

- [Privacy Policy](https://missblue.dev/privacy.md): How Miss Blue collects, uses, shares, and protects personal information.
- [Terms of Service](https://missblue.dev/terms.md): The terms governing access to and use of Miss Blue.