message-square
Notification Requires Integration

Twilio SMS

TwilioSMS

Optional SMS verification with Twilio Lookup phone validation. Can verify sender, recipient, or both. Includes phone number intelligence for fraud prevention.

Published February 16, 2026

Execution Phases

This control can execute during the following transaction phases.

Post-Escrow Executes while funds are held in escrow

Supported Networks

This control is available on the following blockchain networks.

ethereumethereum-sepoliabasebase-sepoliasolanasolana-devnetarbitrumarbitrum-sepoliaoptimismoptimism-sepolia

Integration

This control is powered by an external integration.

Twilio Twilio enables companies to use communications and data to add intelligence and security to every step of the customer journey, from sales to marketing to growth, customer service and many more engagement use cases in a flexible, programmatic way. Across 180 countries, millions of developers and hundreds of thousands of businesses use Twilio to create magical experiences for their customers.
→

Configuration

This control accepts the following configuration parameters. 

{
  "type": "object",
  "required": [
    "requiredFor"
  ],
  "properties": {
    "message": {
      "type": "string",
      "maxLength": 160,
      "description": "Custom SMS message (optional)"
    },
    "requiredFor": {
      "type": "array",
      "items": {
        "enum": [
          "sender",
          "recipient"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Which parties need phone verification"
    },
    "enableLookup": {
      "type": "boolean",
      "default": false,
      "description": "Enable Twilio Lookup for phone number validation and intelligence"
    },
    "lookupOptions": {
      "type": "object",
      "properties": {
        "blockVoip": {
          "type": "boolean",
          "default": false,
          "description": "Block VOIP phone numbers"
        },
        "checkSimSwap": {
          "type": "boolean",
          "default": false,
          "description": "Check for recent SIM swap (fraud indicator)"
        },
        "blockLandline": {
          "type": "boolean",
          "default": false,
          "description": "Block landline phone numbers"
        },
        "requireMobile": {
          "type": "boolean",
          "default": false,
          "description": "Only allow mobile phone numbers"
        },
        "simSwapThresholdDays": {
          "type": "number",
          "default": 7,
          "minimum": 1,
          "description": "Days threshold to consider SIM swap suspicious"
        }
      },
      "description": "Twilio Lookup validation options (only applies when enableLookup is true)"
    },
    "codeExpiration": {
      "type": "number",
      "default": 300,
      "maximum": 600,
      "minimum": 60,
      "description": "Verification code expiration in seconds"
    },
    "verificationRequired": {
      "type": "boolean",
      "default": true,
      "description": "Whether SMS verification is required. If false, only phone lookup is performed."
    }
  }
}

Tags

smstwilionotificationpost-escrow

Documentation

# SMS Notification Control Provides optional SMS verification with Twilio Lookup phone validation. ## Features ### Optional Verification - Set `verificationRequired: false` to skip SMS verification - Still collects phone lookup data when lookup is enabled - Useful when you want phone validation without the verification step ### Twilio Lookup Integration - Enable `enableLookup: true` to validate phone numbers - Returns carrier name, line type (mobile/voip/landline) - Detects SIM swap fraud indicators ### Lookup Validation Options - **blockVoip**: Reject VOIP phone numbers (fraud prevention) - **blockLandline**: Reject landline numbers (can't receive SMS) - **requireMobile**: Only allow mobile phone numbers - **checkSimSwap**: Flag recent SIM swaps as potential fraud ## Configuration Examples ### Basic SMS Verification (Default) ```json { "requiredFor": ["recipient"], "verificationRequired": true } ``` ### Phone Validation Only (No SMS) ```json { "requiredFor": ["recipient"], "verificationRequired": false, "enableLookup": true, "lookupOptions": { "requireMobile": true, "blockVoip": true } } ``` ### Full Verification with Fraud Prevention ```json { "requiredFor": ["sender", "recipient"], "verificationRequired": true, "enableLookup": true, "lookupOptions": { "blockVoip": true, "checkSimSwap": true, "simSwapThresholdDays": 7 } } ```

← Back to Controls