band message send

Send an SMS or MMS message

Synopsis

Sends an SMS or MMS message. The message is queued for delivery (202 Accepted) — actual delivery status arrives via webhook callbacks on your application.

band message send [flags]

Examples

  # Send an SMS
  band message send --to +15551234567 --from +15559876543 --app-id abc-123 --text "Hello world"

  # Send an MMS with media
  band message send --to +15551234567 --from +15559876543 --app-id abc-123 --text "Check this out" --media https://example.com/image.png

  # Group message
  band message send --to +15551234567,+15552345678 --from +15559876543 --app-id abc-123 --text "Hey everyone"

  # Pipe message body from stdin
  echo "Hello from a script" | band message send --to +15551234567 --from +15559876543 --app-id abc-123 --stdin

Options

      --app-id string       Bandwidth messaging application ID (required)
      --expiration string   Message expiration as RFC-3339 datetime
      --from string         Sender phone number in E.164 format (required)
  -h, --help                help for send
      --media strings       Media URL(s) for MMS (repeatable)
      --priority string     Message priority: default or high
      --stdin               Read message body from stdin
      --tag string          Custom tag included in callback events (max 1024 chars)
      --text string         Message body text
      --to strings          Recipient phone number(s) in E.164 format (required, repeatable)

Options inherited from parent commands

      --account-id string    Bandwidth account ID (overrides config)
      --environment string   API environment: prod, test (overrides config)
      --format string        Output format: json or table (default "json")
      --plain                Simplified flat JSON output (recommended for scripts and agents)

SEE ALSO

• band message - Send and manage SMS/MMS messages