Action: Send SMS

Twilio Operation

The Send SMS action sends text messages to mobile numbers using Twilio’s API.

Example User Story

I want to send an SMS alert via Twilio when a user’s payment fails, so they can quickly update their payment method.

Fields

Field Name	Field Type	Required
to	String	Yes
from	String	Yes
body	String	Yes

Related Connections

Twilio

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "send-sms",
  "state": "inDev",
  "meta": {
    "short": "Send SMS",
    "description": "Send an SMS message using Twilio's API."
  },
  "input": [
    {
      "name": "to",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The recipient's phone number in E.164 format."
      }
    },
    {
      "name": "from",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The Twilio phone number to send the SMS from (in E.164 format)."
      }
    },
    {
      "name": "body",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The content of the SMS message."
      }
    }
  ],
  "output": [
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The status of the sent SMS (e.g., 'queued', 'sent', 'failed')."
      }
    },
    {
      "name": "sid",
      "type": "String",
      "selector": ["sid"],
      "meta": {
        "description": "The unique identifier for the sent SMS."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/Messages.json",
        "headers": {
          "Content-Type": "application/x-www-form-urlencoded"
        },
        "bodyTemplate": {
          "value": "To={{to}}&From={{from}}&Body={{body}}",
          "placeholders": [
            {
              "name": "to",
              "type": "String",
              "description": "Recipient's phone number.",
              "required": true
            },
            {
              "name": "from",
              "type": "String",
              "description": "Sender's Twilio phone number.",
              "required": true
            },
            {
              "name": "body",
              "type": "String",
              "description": "SMS message content.",
              "required": true
            }
          ]
        }
      }
    }
  ]
}