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

Bubble Effects

Bubble effects apply to the message bubble itself.

EffectDescription
slamMessage slams down onto the screen
loudMessage appears large and shakes
gentleMessage fades in softly
invisibleInkMessage is hidden until swiped

Screen Effects

Screen effects animate the entire conversation view.

EffectDescription
echoMessage echoes across the screen in copies
spotlightSpotlight highlights the message
balloonsColorful balloons float up
confettiConfetti rains down
loveGiant heart animation
lasersLaser light show
fireworksFireworks burst across the screen

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 ReactionsWhatsApp