# BlueBot docs

> Send texts from your own number with one API call and get every reply as a signed webhook. These docs also cover Zapier, Make, n8n, Pipedream and AI assistants.

BlueBot sends iMessages and SMS from your own phone number. It needs a Mac you own that stays on with Messages signed in. When your app, your Zap or your AI assistant asks BlueBot to send a text, the person gets it from you in their existing conversation with you. Every reply, delivery and read comes back to you as a signed webhook.

- [Send your first text](https://usebluebot.com/docs/quickstart): Get a key and text yourself in four steps. It takes about five minutes.
- [API reference](https://usebluebot.com/docs/api): Every operation, its fields, its errors, and a Try it panel.

**What are you building?**

- [Texts from my own app](https://usebluebot.com/docs/quickstart): Send with one request and react to replies with webhooks.
- [An AI that texts](https://usebluebot.com/docs/mcp): Give Claude, ChatGPT or Cursor tools to text, read and check your Mac.
- [A Zap or a scenario](https://usebluebot.com/docs/zapier): Use Zapier, Make, n8n or Pipedream without writing code.
- [Reminders and follow-ups](https://usebluebot.com/docs/guides/appointment-reminders): Scheduled texts that wait for the right time and stop when someone replies.
- [Replies in my CRM](https://usebluebot.com/docs/guides/hubspot-timeline): Log every text in and out on the person's record.
- [A webhook handler](https://usebluebot.com/docs/webhooks): Get a signed event for every text, with retries and replay.

## How it works

```mermaid
flowchart LR
  App[Your app] -- POST /v1/messages --> BB[BlueBot: queue, rules, holds]
  BB -- claim every 10 s --> Mac[Your Mac]
  Mac --> IM[iMessage from Messages]
  Mac --> SMS[SMS through your iPhone]
  Mac -- replies and states --> BB
  BB -- webhooks --> App
```

Your app calls `POST /v1/messages`. BlueBot checks your sending rules and either queues the text or holds it with a reason. Your Mac checks in every 10 seconds, takes the texts that are ready and hands each one to Messages, which sends it as an iMessage or, through your iPhone, as an SMS. The Mac reads the result back from Messages, and BlueBot tells you with a webhook. Read [How BlueBot works](https://usebluebot.com/docs/concepts/how-it-works) for the whole path.

## What BlueBot is not

- Anyone who wants to text people who didn’t ask to hear from them. BlueBot is not a bulk SMS gateway and has no cold outreach.
- Anyone who needs a number they don’t own. BlueBot sends from your own number and provides none.
- Anyone without a Mac that can stay on with Messages signed in.

BlueBot is for texting people who know you and want to hear from you, such as clients, customers and patients. The [sending rules](https://usebluebot.com/docs/concepts/sending-rules) keep it that way, and they're why your number stays in good standing with Apple and the carriers.

## Where to go next

- [Quickstart](https://usebluebot.com/docs/quickstart): a key, a test text to yourself, and what to know before you send in a loop.
- [Holds](https://usebluebot.com/docs/concepts/holds): why a text waits instead of failing, and when it goes.
- [Webhooks](https://usebluebot.com/docs/webhooks): hear about every text in and out.
- [MCP](https://usebluebot.com/docs/mcp): let an AI assistant text for you under your sending rules.
- [llms.txt](https://usebluebot.com/llms.txt): these docs for a language model, one link per page.