> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Blooio

> Blooio provides stable v2 APIs for messaging, chats, contacts, groups, phone numbers, and account analytics.

![Blooio logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/blooio.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=1c026ac28a0718570a252bdbf96d2bff)

* **Category:** communication
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 26
* **Triggers:** 0
* **Slug:** `BLOOIO`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Contact Tags
>
> **Slug:** `BLOOIO_ADD_CONTACT_TAGS`
>
> Add or reactivate one or more free-form tags on a contact.
>
> #### Input Parameters
>
> **tags** `array` *required*
>
> One or more free-form tag values to add. Existing tags are reactivated without duplication.
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Contact
>
> **Slug:** `BLOOIO_CREATE_CONTACT`
>
> Create a contact from an E.164 phone number or email address, optionally assigning a name.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional human-readable contact name.
>
> **identifier** `string` *required*
>
> Contact phone number in E.164 format or a valid email address.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Group
>
> **Slug:** `BLOOIO_CREATE_GROUP`
>
> Create a messaging group, optionally linking an existing iMessage chat and recording its members; new contacts may be created for unknown members.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Display name for the group.
>
> **members** `array`
>
> Member phone numbers or emails to record. With chat\_guid these do not add participants to the external iMessage chat.
>
> **chat\_guid** `string`
>
> Existing iMessage chat GUID to link; omit to create an API-managed group on first send.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `BLOOIO_DELETE_CONTACT`
>
> Soft-delete one contact identified by E.164 phone number or email.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Group
>
> **Slug:** `BLOOIO_DELETE_GROUP`
>
> Soft-delete a group, remove its members, and exit its linked iMessage chat when one exists.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group identifier returned by create or list groups, beginning with grp\_.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account
>
> **Slug:** `BLOOIO_GET_ACCOUNT`
>
> Return the authenticated organization, assigned devices, and message usage without exposing the API-key identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Chat
>
> **Slug:** `BLOOIO_GET_CHAT`
>
> Return detailed counts, participant context, and latest-message metadata for one conversation.
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipient identifiers for the conversation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `BLOOIO_GET_CONTACT`
>
> Return one contact by E.164 phone number or email, including its current tags.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email address.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Capabilities
>
> **Slug:** `BLOOIO_GET_CONTACT_CAPABILITIES`
>
> Check whether a contact can receive iMessage, SMS, or FaceTime before choosing a communication path.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Group
>
> **Slug:** `BLOOIO_GET_GROUP`
>
> Return one messaging group by its grp\_ identifier.
>
> #### Input Parameters
>
> **group\_id** `string` *required*
>
> Group identifier returned by create or list groups, beginning with grp\_.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Message
>
> **Slug:** `BLOOIO_GET_MESSAGE`
>
> Return one message with content, reactions, delivery status, protocol, errors, and inline-reply context.
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipients identifying the chat.
>
> **message\_id** `string` *required*
>
> Message identifier returned by send, list messages, or a webhook, beginning with msg\_.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Poll Results
>
> **Slug:** `BLOOIO_GET_POLL_RESULTS`
>
> Return a poll's definition, option vote counts, and total votes.
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipient identifiers for the chat.
>
> **poll\_id** `string` *required*
>
> Poll identifier returned by Send Poll or a poll webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Risk Summary
>
> **Slug:** `BLOOIO_GET_RISK_SUMMARY`
>
> Return the organization-wide fleet risk summary, recomputed on request for eligible dedicated and inbound numbers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Chats
>
> **Slug:** `BLOOIO_LIST_CHATS`
>
> Search and page through conversations, ordered by recent activity or oldest activity.
>
> #### Input Parameters
>
> **sort** `string ("recent" | "oldest")`
>
> Order chats by most recent or oldest activity.
>
> **limit** `integer`
>
> Maximum chats to return in this page (1-200).
>
> **query** `string`
>
> Search text matched against phone number, email, or contact name.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `BLOOIO_LIST_CONTACTS`
>
> Search and page through organization contacts by identifier or name.
>
> #### Input Parameters
>
> **sort** `string ("recent" | "oldest" | "name_asc" | "name_desc")`
>
> Order contacts by activity age or name.
>
> **limit** `integer`
>
> Maximum contacts to return in this page (1-200).
>
> **query** `string`
>
> Case-insensitive search text matched against contact identifier or name.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Group Members
>
> **Slug:** `BLOOIO_LIST_GROUP_MEMBERS`
>
> Page through the members recorded for a messaging group.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum members to return in this page (1-200).
>
> **group\_id** `string` *required*
>
> Group identifier returned by create or list groups, beginning with grp\_.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Groups
>
> **Slug:** `BLOOIO_LIST_GROUPS`
>
> Search and page through messaging groups by name.
>
> #### Input Parameters
>
> **sort** `string ("recent" | "oldest" | "name_asc" | "name_desc")`
>
> Order groups by activity age or name.
>
> **limit** `integer`
>
> Maximum groups to return in this page (1-200).
>
> **query** `string`
>
> Search text matched against group name.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Messages
>
> **Slug:** `BLOOIO_LIST_MESSAGES`
>
> Page through messages in one chat with direction, time-window, and ordering filters.
>
> #### Input Parameters
>
> **sort** `string ("asc" | "desc")`
>
> Order messages by send time ascending or descending.
>
> **limit** `integer`
>
> Maximum messages to return in this page (1-200).
>
> **since** `integer`
>
> Only messages sent after this Unix epoch timestamp in milliseconds.
>
> **until** `integer`
>
> Only messages sent before this Unix epoch timestamp in milliseconds.
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipient identifiers for the conversation.
>
> **direction** `string ("inbound" | "outbound")`
>
> Return only inbound or outbound messages; omit for both.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Numbers
>
> **Slug:** `BLOOIO_LIST_NUMBERS`
>
> List sender phone numbers assigned to the connected API key and their availability state.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Chat Read
>
> **Slug:** `BLOOIO_MARK_CHAT_READ`
>
> Mark every message in a chat as read and irreversibly send an externally visible read receipt to the sender; the receipt cannot be unsent.
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipients identifying the chat.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Contact Tags
>
> **Slug:** `BLOOIO_REMOVE_CONTACT_TAGS`
>
> Soft-delete one or more exact tags from a contact sequentially; if a later removal fails, earlier removals remain applied.
>
> #### Input Parameters
>
> **tags** `array` *required*
>
> One or more exact tag values to remove sequentially. If a later removal fails, earlier removals remain applied.
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Message
>
> **Slug:** `BLOOIO_SEND_MESSAGE`
>
> Irreversibly send one or multiple text, attachment, multipart, or inline-reply messages; multi-recipient sends may create or reuse an unnamed group and may incur messaging charges.
>
> #### Input Parameters
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipients. Multi-recipient sends may create or reuse an unnamed group.
>
> **content** `string` *required*
>
> Required message content; choose exactly one text, attachments, or multipart variant.
>
> **reply\_to** `string`
>
> iMessage inline-reply target. Replies must use the same chat and sender and cannot target messages older than 30 days.
>
> **from\_number** `string`
>
> Assigned E.164 sender number. Omit to let Blooio select a sender where the connected API key supports that.
>
> **idempotency\_key** `string`
>
> Stable unique key for this logical send. Reusing it returns the original message result and prevents duplicate delivery.
>
> **use\_typing\_indicator** `boolean`
>
> Whether to show a temporary typing indicator before sending. Omit to use the organization preference.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Poll
>
> **Slug:** `BLOOIO_SEND_POLL`
>
> Irreversibly send an interactive native iMessage poll to a chat.
>
> #### Input Parameters
>
> **title** `string`
>
> Optional poll title or question.
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipients identifying the chat.
>
> **options** `array` *required*
>
> Poll choices in display order. The v2 contract does not document a stricter count limit.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Message Reaction
>
> **Slug:** `BLOOIO_SET_MESSAGE_REACTION`
>
> Add or remove a classic tapback or emoji reaction on a specific or relative message in a chat.
>
> #### Input Parameters
>
> **action** `string ("add" | "remove")` *required*
>
> Whether to add or remove the reaction.
>
> **chat\_id** `string` *required*
>
> Phone number, email, grp\_ group ID, or comma-separated recipients identifying the chat.
>
> **reaction** `string` *required*
>
> Classic tapback name (love, like, dislike, laugh, emphasize, question) or one emoji, without a leading + or - prefix.
>
> **direction** `string ("inbound" | "outbound")`
>
> Optional direction filter used when message\_id is a relative index.
>
> **message\_id** `string` *required*
>
> Exact msg\_ identifier or a relative index such as -1 for the latest message.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `BLOOIO_UPDATE_CONTACT`
>
> Set or clear the display name of an existing contact.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New contact name, or null to clear the current name.
>
> **contact\_id** `string` *required*
>
> Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Group
>
> **Slug:** `BLOOIO_UPDATE_GROUP`
>
> Rename a group and report the linked iMessage chat synchronization result when available.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> New group display name.
>
> **group\_id** `string` *required*
>
> Group identifier returned by create or list groups, beginning with grp\_.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
