MessagesMessage Effects

Message Effects

Add visual effects to iMessage messages using the effect field. Effects are silently ignored if the message falls back to SMS.

Usage

curl -X POST https://api.textbubbles.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "content": { "text": "Congratulations!" },
    "effect": "fireworks"
  }'

Available Effects

Screen Effects

EffectDescription
fireworksFireworks burst across the screen
balloonsColorful balloons float up
confettiConfetti rains down
lasersLaser light show
spotlightSpotlight highlights the message

Bubble Effects

EffectDescription
slamMessage slams down onto the screen
loudMessage appears large and shakes
gentleMessage fades in softly
invisibleInkMessage is hidden until swiped
echoMessage echoes across the screen
loveHeart animation on the message bubble

Notes

  • Effects are iMessage only — silently ignored on SMS
  • Effects can be combined with attachments and carousels
  • The effect field is optional on all message-sending endpoints
Tapback ReactionsGroup Chats