# Blooio > Blooio is an iMessage and SMS automation platform for businesses. Send and receive iMessages and SMS directly from your CRM or automation platform using dedicated phone numbers, real-time delivery tracking, webhook events, and powerful workflow automations. The REST API supports contacts, groups, reactions, typing indicators, read receipts, and attachments. - [Home](https://blooio.com/): Product overview, features, and pricing. - [Pricing](https://blooio.com/pricing.md): Complete pricing for all plans, feature comparison tables, and volume discounts. - [Book a Meeting](https://blooio.com/book-a-meeting): Schedule a live demo with our team. - [Free Trial](https://blooio.com/#free-trial): Sign-up page for a 14-day free trial (no credit card required). - [Feature Log](https://blooio.com/feature-log): Released features and upcoming roadmap. ## Integrations - [Integrations Overview](https://blooio.com/integrations): All available native integrations and connection guides. - [High Level](https://blooio.com/integrations/high-level): Native iMessage inside Go High Level CRM. - [n8n](https://blooio.com/integrations/n8n): Low-code workflows that trigger and react to iMessages. - [Freshdesk](https://blooio.com/integrations/freshdesk): Turn iMessage conversations into Freshdesk support tickets. - [HubSpot](https://blooio.com/integrations/hubspot): Sync iMessages with HubSpot CRM for sales and marketing workflows. - [API](https://blooio.com/integrations/api): REST API for custom applications and backend services. ## Documentation - [Docs](https://docs.blooio.com): Full developer documentation for the Blooio API v2. - [OpenAPI Specification](https://backend.blooio.com/v2/api/openapi.json): Complete OpenAPI 3.0 spec (machine-readable JSON). - [AI & LLMs Reference](https://docs.blooio.com/api-reference/for-llms): Machine-readable API documentation for AI assistants and code generation tools. ### Getting Started - [Overview](https://docs.blooio.com): Send and manage iMessage/SMS with a simple API. - [Quickstart](https://docs.blooio.com/quickstart): Send your first message and receive webhooks in minutes. - [Development](https://docs.blooio.com/development): Set up a local environment to test the Blooio API and webhooks. ### Concepts - [Authentication](https://docs.blooio.com/authentication): Authenticate API requests using Bearer tokens. - [Idempotency](https://docs.blooio.com/idempotency): Safely retry message creation using Idempotency-Key headers. - [Number Pools](https://docs.blooio.com/number-pools): How sender number selection works for Blooio and Twilio messages. ### How-to Guides - [Message sending basics](https://docs.blooio.com/guides/message-sending): A complete guide to sending messages, including chat IDs, options, and common quirks. - [Receive webhooks locally](https://docs.blooio.com/development#receive-webhooks-locally): Tunnel your local server and test Blooio webhook deliveries. - [Verify webhook signatures](https://docs.blooio.com/guides/webhook-signatures): Cryptographically verify that webhooks are genuinely from Blooio. - [Send attachments](https://docs.blooio.com/guides/attachments): Include media URLs when sending messages. - [Contact flows](https://docs.blooio.com/guides/contact-flows): Check iMessage/SMS capabilities and choose the best channel. - [Error handling & retries](https://docs.blooio.com/guides/error-handling): Handle common errors, rate limits, and implement safe retries. - [Twilio Integration](https://docs.blooio.com/guides/twilio-integration): Send SMS/MMS messages using your own Twilio account. ### Reference - [API Introduction](https://docs.blooio.com/api-reference/introduction): Send and manage messages via simple HTTP endpoints. All endpoints are under /v2/api and use Bearer auth. - [Errors](https://docs.blooio.com/api-reference/errors): Standard error format and common error cases returned by the API. - [Webhook events](https://docs.blooio.com/api-reference/webhook-events): Event types, headers, payloads, and signature verification for Blooio webhooks. ## API Endpoints Base URL: `https://backend.blooio.com/v2/api` OpenAPI spec: `https://backend.blooio.com/v2/api/openapi.json` ### Account - [Get current authentication context](https://docs.blooio.com/account/getMe): GET /me — Returns details about the authenticated API key or dashboard user, including organization info, devices, and usage statistics. ### Contacts - [List contacts](https://docs.blooio.com/contacts/listContacts): GET /contacts — List all contacts with optional search and pagination. - [Create a contact](https://docs.blooio.com/contacts/createContact): POST /contacts — Create a new contact with a phone number (E.164) or email. - [Get a contact](https://docs.blooio.com/contacts/getContact): GET /contacts/{contactId} — Get details for a specific contact. - [Update a contact](https://docs.blooio.com/contacts/updateContact): PATCH /contacts/{contactId} — Update a contact's name. - [Delete a contact](https://docs.blooio.com/contacts/deleteContact): DELETE /contacts/{contactId} — Soft-delete a contact. - [Check contact capabilities](https://docs.blooio.com/contacts/getContactCapabilities): GET /contacts/{contactId}/capabilities — Check if a contact supports iMessage and/or SMS. ### Groups - [List groups](https://docs.blooio.com/groups/listGroups): GET /groups — List all groups with optional search and pagination. - [Create a group](https://docs.blooio.com/groups/createGroup): POST /groups — Create a new group with name and optional members. - [Get a group](https://docs.blooio.com/groups/getGroup): GET /groups/{groupId} — Get details for a specific group. - [Update a group](https://docs.blooio.com/groups/updateGroup): PATCH /groups/{groupId} — Update a group's name. - [Delete a group](https://docs.blooio.com/groups/deleteGroup): DELETE /groups/{groupId} — Soft-delete a group and leave the device chat. - [Set group icon](https://docs.blooio.com/groups/setGroupIcon): POST /groups/{groupId}/icon — Upload a group icon/photo. - [Remove group icon](https://docs.blooio.com/groups/removeGroupIcon): DELETE /groups/{groupId}/icon — Remove the group icon/photo. ### Group Members - [List group members](https://docs.blooio.com/group-members/listGroupMembers): GET /groups/{groupId}/members — List all members of a group. - [Add a member to a group](https://docs.blooio.com/group-members/addGroupMember): POST /groups/{groupId}/members — Add a contact to a group (coming soon). - [Remove a member from a group](https://docs.blooio.com/group-members/removeGroupMember): DELETE /groups/{groupId}/members/{contactId} — Remove a contact from a group (coming soon). ### Messages - [Send a message](https://docs.blooio.com/messages/sendMessage): POST /chats/{chatId}/messages — Send a message to a phone number, email, group, or multi-recipient chat. - [List messages in a chat](https://docs.blooio.com/messages/listChatMessages): GET /chats/{chatId}/messages — List all messages in a conversation with optional filtering. - [Get a message](https://docs.blooio.com/messages/getMessage): GET /chats/{chatId}/messages/{messageId} — Get details for a specific message. - [Get message status](https://docs.blooio.com/messages/getMessageStatus): GET /chats/{chatId}/messages/{messageId}/status — Get delivery status for a specific message. ### Chats - [List chats](https://docs.blooio.com/chats/listChats): GET /chats — List all conversations sorted by most recent message. - [Get a chat](https://docs.blooio.com/chats/getChat): GET /chats/{chatId} — Get details for a specific conversation. ### Webhooks - [List webhooks](https://docs.blooio.com/webhooks/listWebhooks): GET /webhooks — List all webhooks for the organization. - [Create a webhook](https://docs.blooio.com/webhooks/createWebhook): POST /webhooks — Create a new webhook subscription (returns signing_secret once). - [Get a webhook](https://docs.blooio.com/webhooks/getWebhook): GET /webhooks/{webhookId} — Get details for a specific webhook. - [Update a webhook](https://docs.blooio.com/webhooks/updateWebhook): PATCH /webhooks/{webhookId} — Update a webhook's type or expiration. - [Delete a webhook](https://docs.blooio.com/webhooks/deleteWebhook): DELETE /webhooks/{webhookId} — Permanently delete a webhook. ### Webhook Logs - [List webhook logs](https://docs.blooio.com/webhook-logs/listWebhookLogs): GET /webhooks/{webhookId}/logs — List delivery logs for a specific webhook. - [Replay a webhook event](https://docs.blooio.com/webhook-logs/replayWebhookEvent): POST /webhooks/{webhookId}/logs/{eventId}/replay — Re-send a webhook event. ### Reactions - [Add or remove a reaction](https://docs.blooio.com/reactions/addReaction): POST /chats/{chatId}/messages/{messageId}/reactions — Add or remove a reaction (love, like, dislike, laugh, emphasize, question). ### Typing Indicators - [Start typing indicator](https://docs.blooio.com/typing-indicators/startTyping): POST /chats/{chatId}/typing — Show the typing indicator to the recipient. - [Stop typing indicator](https://docs.blooio.com/typing-indicators/stopTyping): DELETE /chats/{chatId}/typing — Stop the typing indicator. ### Read Receipts - [Mark chat as read](https://docs.blooio.com/read-receipts/markChatRead): POST /chats/{chatId}/read — Mark all messages in a chat as read and send a read receipt. ## Legal - [Privacy Policy](https://blooio.com/privacy-policy): Data handling and privacy practices. - [Terms of Service](https://blooio.com/terms-of-service): Usage terms and customer obligations.