MessageMedia SMS Sender

Send SMS via MessageMedia

MessageMedia SMS Sender

AI-generated

Overview

This node sends SMS messages via the MessageMedia service. It is useful for automating SMS notifications, alerts, or marketing messages to phone numbers in E.164 format. Users can specify the recipient number, sender number (from account or custom), message content, and additional options like encoding, rate limiting, and delivery status callbacks. It supports sandbox mode for validation without sending and test mode for redirecting requests to a stub URL.

Use Case Examples

  1. Send SMS alerts to customers when their order status changes.
  2. Automate marketing SMS campaigns with custom sender numbers.
  3. Validate SMS messages in sandbox mode before actual sending.

Properties

Name Meaning
To Destination phone number in E.164 format to which the SMS will be sent.
From (Account Numbers) Choose whether to send SMS from an account phone number or a custom number.
Account Phone Number Select a sender phone number from the available account numbers (shown if 'Use Account Number' is selected).
From (Custom) Enter a custom sender phone number in E.164 format (shown if 'Custom Number' is selected).
Message The SMS message content to send, up to 1600 characters.
Use Sandbox (Dry Run) If enabled, validates the message but does not send it, returning a simulated success response.
Test Mode (Stub URL) If enabled, redirects the request to httpbin.org for testing without sending a real SMS.
Additional Fields Optional fields including status callback URL, encoding type, rate limit delay, fail on undeliverable flag, and whether to return raw provider response.

Output

JSON

  • provider - The SMS provider used, always 'MessageMedia'.
  • to - The normalized destination phone number.
  • from - The sender phone number used.
  • message - The SMS message content sent.
  • status - The status of the message (e.g., 'queued', 'failed').
  • providerMessageId - The unique message ID assigned by the provider.
  • error - Error message if sending failed, otherwise null.
  • raw - Optional raw response from the provider if 'Return Raw' is enabled.
  • meta
    • cost
      * currency - Currency of the cost, always 'USD'.
      * amount - Cost amount, always 0 as cost is not calculated here.
    • encoding - Character encoding detected or specified for the message.
    • queuedAt - Timestamp when the message was queued.
    • rateLimitAppliedMs - Milliseconds delay applied between messages due to rate limiting.

Dependencies

  • MessageMedia API credentials (API key and secret)

Troubleshooting

  • Invalid phone number errors occur if the 'To' or 'From' numbers are not in valid E.164 format. Ensure numbers are correctly formatted.
  • If 'Custom Number' is selected for sender but no number is provided, an error is thrown. Provide a valid custom sender number.
  • Message length must be between 1 and 1600 characters; otherwise, an error is thrown.
  • If 'Fail if Undeliverable' is enabled, any validation or sending error will cause the node to throw an error and stop execution.
  • API credential errors may occur if MessageMedia API credentials are missing or invalid.

Links

Discussion