> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ibubbl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Send iMessages from your own iBubbl line and get the replies on your server.

With the iBubbl API, your software sends real iMessages, the blue bubbles, from a dedicated line that iBubbl runs for you, and gets every reply pushed to your server, usually within a minute. There's no Mac, Apple ID or phone to manage on your side.

* **Send messages** to one contact or to a group, from your iBubbl line. When the recipient can't be reached on iMessage, the message goes out as a text instead, and its `channel` tells you which.
* **Receive replies and status changes** as [webhooks](https://docs.ibubbl.com/webhooks/overview.md): inbound messages, sent / delivered / read, reactions, edits and opt-outs.
* **Keep contacts in sync**: create, update and tag them.
* **Stay compliant by default**: opt-outs, each contact's sending hours and your line's send limits are enforced for you.

The API is HTTPS and JSON, authenticated with one Bearer API key. There's no SDK to install: any HTTP client works.

```bash theme={null}
curl -X POST https://api.ibubbl.com/v1/messages \
  -H "Authorization: Bearer $IBUBBL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "body": "Hey Sam, quick check-in about your order.",
    "idempotency_key": "a3f2c8d9-e0f1-4b4d-9c5a-7b8e2d1f0c4a"
  }'
```

The API answers `202 Accepted` right away; the message then goes out from your line, and its progress arrives as webhook events. The [Quickstart](https://docs.ibubbl.com/quickstart.md) walks through it end to end, sending to your own phone.

> [!NOTE]
>
> Every request is live: there is no sandbox or test mode, and a send delivers a real message. You need an active iBubbl line before you can send; iBubbl sets it up for you.

## Base URL

```
https://api.ibubbl.com
```

All endpoints are under `/v1`. See [Versioning](https://docs.ibubbl.com/versioning.md) for what can and can't change within it.

## Where to go next

> [card] [Quickstart](https://docs.ibubbl.com/quickstart.md)
>
> Create a key, send to your own phone, check the status, receive a reply.

> [card] [Authentication](https://docs.ibubbl.com/authentication.md)
>
> API key format, rotation and security practices.

> [card] [Webhooks](https://docs.ibubbl.com/webhooks/overview.md)
>
> Get replies and status changes pushed to your server.

> [card] [API reference](https://docs.ibubbl.com/api-reference/messages/send.md)
>
> Every endpoint, with request and response schemas.

> [card] [Build with AI](https://docs.ibubbl.com/build-with-ai.md)
>
> llms.txt, Markdown pages, the docs MCP server and a system prompt for coding agents.

> [card] [Support](https://docs.ibubbl.com/support.md)
>
> Email us, and what to include so we can answer quickly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.