API reference # Blue bubbles, from your own code. One key, one project, and a small API that sends iMessage, reads the replies, and tells you what happened. Use the guides for account setup and calling, or the reference for supported integration endpoints. One key, one project A key acts on its project's numbers and reads its messages. It sees nothing belonging to any other project, including others in the same workspace — the separation an agency's clients depend on. No user behind it Deliberate: an integration should keep working after the person who set it up leaves. Revocation takes effect on the next request; nothing is cached. 600 requests a minute Over it you get 429 with a Retry-After in seconds. Sending is paced separately per number so a burst does not look like spam to Apple. ## Authenticating A bearer token on every request. Make one in the console under your project’s API keys. If you lose it, an admin, or whoever made it, can show it again there. ```bash curl https://api.missblue.dev/v1/numbers \ -H "Authorization: Bearer mb_live_..." ``` No key, an unknown key, or a revoked one all return `401`. Anything belonging to another project returns `404` rather than `403`, because confirming it exists would itself be the disclosure. Use an `mb_sandbox_` key for isolated simulated responses and signed test webhooks. No paid number is needed. Read the [sandbox guide](https://missblue.dev/docs/sandbox). Legacy `mb_test_` keys still reach real traffic. Regular phone calling and account billing require a signed-in person. ## The reference [GoHighLevel workflows and inbox API calls, signed webhooks, media, and the GHL provider setup.](https://missblue.dev/docs/gohighlevel) [Sandbox API Virtual numbers, simulated outcomes and isolated webhook events. 5](https://missblue.dev/docs/sandbox-api) [Identity What this key is, and which project it holds. 1](https://missblue.dev/docs/identity) [Messages Send, read, react, unsend, and see what failed. 11](https://missblue.dev/docs/messages) [Conversations Threads, history sync, read receipts, and typing indicators. 9](https://missblue.dev/docs/conversations-api) [Group conversations Create groups, pull metadata, and manage names, photos, and people. 4](https://missblue.dev/docs/groups) [Location sharing Request Find My sharing, pull its state, or watch live fixes. 3](https://missblue.dev/docs/locations) [Calls FaceTime signaling, shared phone and FaceTime history, recordings. 14](https://missblue.dev/docs/calls) [Lookup Which services have reached a handle. 1](https://missblue.dev/docs/lookup) [Contacts Names for handles, shared by the project. 9](https://missblue.dev/docs/contacts) [Attachments Upload a file, then send it. 2](https://missblue.dev/docs/attachments) [Numbers Pull lines, label them, forward calls, manage sender identity, and check recipients. 9](https://missblue.dev/docs/numbers) [Campaigns Announcements, scheduled messages, lists, tags, and automations created entirely through the API, including multi-step sequences with waits, reply conditions and messages personalized from each contact's name and custom fields. 37](https://missblue.dev/docs/campaigns-api) [Delivery Webhooks and per-message callbacks. 7](https://missblue.dev/docs/delivery) [Dedicated numbers and billing Workspace scope, ZIP preferences, number transfers, forwarding, and billing.](https://missblue.dev/docs/dedicated-numbers) [Calling and recordings FaceTime Audio, phone calls, history, playback, and troubleshooting.](https://missblue.dev/docs/calling) [Errors One shape, and what each status means.](https://missblue.dev/docs/errors) [Next Sending messages Your first message, in two calls.](https://missblue.dev/docs/sending-messages)