Skip to main content
Blooio logo
  • Category: communication
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 26
  • Triggers: 0
  • Slug: BLOOIO
  • Version: 20261101_00

Tools

Slug: BLOOIO_ADD_CONTACT_TAGSAdd or reactivate one or more free-form tags on a contact.

Input Parameters

array
required
One or more free-form tag values to add. Existing tags are reactivated without duplication.
string
required
Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_CREATE_CONTACTCreate a contact from an E.164 phone number or email address, optionally assigning a name.

Input Parameters

string
Optional human-readable contact name.
string
required
Contact phone number in E.164 format or a valid email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_CREATE_GROUPCreate a messaging group, optionally linking an existing iMessage chat and recording its members; new contacts may be created for unknown members.

Input Parameters

string
required
Display name for the group.
array
Member phone numbers or emails to record. With chat_guid these do not add participants to the external iMessage chat.
string
Existing iMessage chat GUID to link; omit to create an API-managed group on first send.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_DELETE_CONTACTSoft-delete one contact identified by E.164 phone number or email.

Input Parameters

string
required
Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_DELETE_GROUPSoft-delete a group, remove its members, and exit its linked iMessage chat when one exists.

Input Parameters

string
required
Group identifier returned by create or list groups, beginning with grp_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_ACCOUNTReturn the authenticated organization, assigned devices, and message usage without exposing the API-key identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_CHATReturn detailed counts, participant context, and latest-message metadata for one conversation.

Input Parameters

string
required
Phone number, email, grp_ group ID, or comma-separated recipient identifiers for the conversation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_CONTACTReturn one contact by E.164 phone number or email, including its current tags.

Input Parameters

string
required
Contact identifier as an E.164 phone number or valid email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_CONTACT_CAPABILITIESCheck whether a contact can receive iMessage, SMS, or FaceTime before choosing a communication path.

Input Parameters

string
required
Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_GROUPReturn one messaging group by its grp_ identifier.

Input Parameters

string
required
Group identifier returned by create or list groups, beginning with grp_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_MESSAGEReturn one message with content, reactions, delivery status, protocol, errors, and inline-reply context.

Input Parameters

string
required
Phone number, email, grp_ group ID, or comma-separated recipients identifying the chat.
string
required
Message identifier returned by send, list messages, or a webhook, beginning with msg_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_POLL_RESULTSReturn a poll’s definition, option vote counts, and total votes.

Input Parameters

string
required
Phone number, email, grp_ group ID, or comma-separated recipient identifiers for the chat.
string
required
Poll identifier returned by Send Poll or a poll webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_GET_RISK_SUMMARYReturn the organization-wide fleet risk summary, recomputed on request for eligible dedicated and inbound numbers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_CHATSSearch and page through conversations, ordered by recent activity or oldest activity.

Input Parameters

string ("recent" | "oldest")
Order chats by most recent or oldest activity.
integer
Maximum chats to return in this page (1-200).
string
Search text matched against phone number, email, or contact name.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_CONTACTSSearch and page through organization contacts by identifier or name.

Input Parameters

string ("recent" | "oldest" | "name_asc" | "name_desc")
Order contacts by activity age or name.
integer
Maximum contacts to return in this page (1-200).
string
Case-insensitive search text matched against contact identifier or name.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_GROUP_MEMBERSPage through the members recorded for a messaging group.

Input Parameters

integer
Maximum members to return in this page (1-200).
string
required
Group identifier returned by create or list groups, beginning with grp_.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_GROUPSSearch and page through messaging groups by name.

Input Parameters

string ("recent" | "oldest" | "name_asc" | "name_desc")
Order groups by activity age or name.
integer
Maximum groups to return in this page (1-200).
string
Search text matched against group name.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_MESSAGESPage through messages in one chat with direction, time-window, and ordering filters.

Input Parameters

string ("asc" | "desc")
Order messages by send time ascending or descending.
integer
Maximum messages to return in this page (1-200).
integer
Only messages sent after this Unix epoch timestamp in milliseconds.
integer
Only messages sent before this Unix epoch timestamp in milliseconds.
string
required
Phone number, email, grp_ group ID, or comma-separated recipient identifiers for the conversation.
string ("inbound" | "outbound")
Return only inbound or outbound messages; omit for both.
string
Continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_LIST_NUMBERSList sender phone numbers assigned to the connected API key and their availability state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_MARK_CHAT_READMark 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

string
required
Phone number, email, grp_ group ID, or comma-separated recipients identifying the chat.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_REMOVE_CONTACT_TAGSSoft-delete one or more exact tags from a contact sequentially; if a later removal fails, earlier removals remain applied.

Input Parameters

array
required
One or more exact tag values to remove sequentially. If a later removal fails, earlier removals remain applied.
string
required
Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_SEND_MESSAGEIrreversibly 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

string
required
Phone number, email, grp_ group ID, or comma-separated recipients. Multi-recipient sends may create or reuse an unnamed group.
string
required
Required message content; choose exactly one text, attachments, or multipart variant.
string
iMessage inline-reply target. Replies must use the same chat and sender and cannot target messages older than 30 days.
string
Assigned E.164 sender number. Omit to let Blooio select a sender where the connected API key supports that.
string
Stable unique key for this logical send. Reusing it returns the original message result and prevents duplicate delivery.
boolean
Whether to show a temporary typing indicator before sending. Omit to use the organization preference.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_SEND_POLLIrreversibly send an interactive native iMessage poll to a chat.

Input Parameters

string
Optional poll title or question.
string
required
Phone number, email, grp_ group ID, or comma-separated recipients identifying the chat.
array
required
Poll choices in display order. The v2 contract does not document a stricter count limit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_SET_MESSAGE_REACTIONAdd or remove a classic tapback or emoji reaction on a specific or relative message in a chat.

Input Parameters

string ("add" | "remove")
required
Whether to add or remove the reaction.
string
required
Phone number, email, grp_ group ID, or comma-separated recipients identifying the chat.
string
required
Classic tapback name (love, like, dislike, laugh, emphasize, question) or one emoji, without a leading + or - prefix.
string ("inbound" | "outbound")
Optional direction filter used when message_id is a relative index.
string
required
Exact msg_ identifier or a relative index such as -1 for the latest message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_UPDATE_CONTACTSet or clear the display name of an existing contact.

Input Parameters

string
required
New contact name, or null to clear the current name.
string
required
Contact identifier as an E.164 phone number or valid email; the tool URL-encodes it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BLOOIO_UPDATE_GROUPRename a group and report the linked iMessage chat synchronization result when available.

Input Parameters

string
required
New group display name.
string
required
Group identifier returned by create or list groups, beginning with grp_.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not