CLI Reference

npm install -g @textbubbles/js

npx @textbubbles/js <command>

textbubbles login
# Enter your API key when prompted

export TEXTBUBBLES_API_KEY=tb_your_api_key

textbubbles whoami

textbubbles logout

# Basic message
textbubbles send "+14155551234" "Hello from CLI!"
 
# With effect
textbubbles send "+14155551234" "Congrats!" --effect confetti
 
# With media
textbubbles send "+14155551234" "Check this out" --media https://example.com/image.jpg

textbubbles send:carousel "+14155551234" \
  https://example.com/img1.jpg \
  https://example.com/img2.jpg \
  https://example.com/img3.jpg

textbubbles send:schedule "+14155551234" "Good morning!" \
  --at "2026-03-29T09:00:00Z"

# All messages
textbubbles messages list
 
# Filter by recipient
textbubbles messages list --to "+14155551234"
 
# Limit results
textbubbles messages list --limit 10
 
# JSON output
textbubbles messages list --json

textbubbles messages get msg_abc123

textbubbles messages cancel msg_abc123

# All contacts
textbubbles contacts list
 
# Filter by tag
textbubbles contacts list --tag vip
 
# Search by name
textbubbles contacts list --search "Jane"

textbubbles contacts create \
  --phone "+14155551234" \
  --name "Jane Doe" \
  --email "jane@example.com" \
  --tags vip,customer

textbubbles contacts get contact_abc123

textbubbles contacts delete contact_abc123

textbubbles check "+14155551234"

+14155551234: iMessage ✓

textbubbles webhooks get

textbubbles webhooks set https://example.com/webhooks/textbubbles \
  --secret whsec_your_secret \
  --events message.received,message.delivered

textbubbles pay:request "+14155551234" 25.00 --memo "For lunch"

textbubbles pay:list

textbubbles pay:cancel pay_abc123

{
  "apiKey": "tb_your_api_key",
  "baseUrl": "https://api.textbubbles.com"
}

for phone in "+14155551234" "+14155555678" "+14155559999"; do
  textbubbles send "$phone" "Hello!"
done

textbubbles messages list --json > messages.json

cat numbers.txt | while read phone; do
  textbubbles check "$phone"
done