Twilio SMS/MMS Notification¶
Class: TwilioSMSNotificationBlockV2
Source: inference.core.workflows.core_steps.sinks.twilio.sms.v2.TwilioSMSNotificationBlockV2
The Twilio SMS/MMS Notification block allows users to send text and multimedia messages as part of a workflow.
SMS Provider Options¶
This block supports two SMS delivery methods via a dropdown selector:
- Roboflow Managed API Key (Default) - No Twilio configuration needed. Messages are sent through Roboflow's proxy service:
- Simplified setup - just provide message, recipient, and optional media
- Secure - your workflow API key is used for authentication
- No Twilio account required
-
Pricing: US/Canada: 30 messages per credit. International: 10 messages per credit. (SMS and MMS priced the same)
-
Custom Twilio - Use your own Twilio account:
- Full control over message delivery
- Requires Twilio credentials (Account SID, Auth Token, Phone Number)
- You pay Twilio directly for messaging
Message Content¶
-
Receiver Number: Phone number to receive the message (must be in E.164 format, e.g., +15551234567)
-
Message: The body content of the SMS/MMS. Message can be parametrised with data generated during workflow run. See Dynamic Parameters section.
-
Media URL (Optional): For MMS messages, provide image URL(s) or image outputs from visualization blocks
Dynamic Parameters¶
Message content can be parametrised with Workflow execution outcomes. Example:
message = "Alert! Detected {{ '{{' }} $parameters.num_detections {{ '}}' }} objects"
Message parameters are set via message_parameters:
message_parameters = {
"num_detections": "$steps.model.predictions"
}
Transform data using message_parameters_operations:
message_parameters_operations = {
"predictions": [
{"type": "DetectionsPropertyExtract", "property_name": "class_name"}
]
}
MMS Support¶
Send images with your message by providing media_url:
- Image URLs: Provide publicly accessible image URLs as a string or list
- Workflow Images: Reference image outputs from visualization blocks
- Base64 Images: Images are automatically converted for transmission
Example:
media_url = "$steps.bounding_box_visualization.image"
Or multiple images:
media_url = ["https://example.com/image1.jpg", "https://example.com/image2.jpg"]
Note: MMS is primarily supported in US/Canada. International MMS availability varies by carrier.
Using Custom Twilio¶
To use your own Twilio account, select "Custom Twilio" and configure:
twilio_account_sid- Your Twilio Account SID from the Twilio Consoletwilio_auth_token- Your Twilio Auth Tokensender_number- Your Twilio phone number (must be in E.164 format)
Cooldown¶
The block accepts cooldown_seconds (defaults to 5 seconds) to prevent notification bursts. Set 0 for no cooldown.
During cooldown, the throttling_status output is set to True and no message is sent.
Cooldown limitations
Cooldown is limited to video processing. Using this block in HTTP service workflows (Roboflow Hosted API, Dedicated Deployment) has no cooldown effect for HTTP requests.
Async Execution¶
Set fire_and_forget=True to send messages in the background, allowing the Workflow to proceed.
With async mode, error_status is always False. Set fire_and_forget=False for debugging.
Disabling Notifications¶
Set disable_sink flag to manually disable the notifier block via Workflow input.
Type identifier¶
Use the following identifier in step "type" field: roboflow_core/twilio_sms_notification@v2to add the block as
as step in your workflow.
Properties¶
| Name | Type | Description | Refs |
|---|---|---|---|
name |
str |
Enter a unique identifier for this step.. | ❌ |
sms_provider |
str |
Choose SMS delivery method: use Roboflow's managed service or configure your own Twilio account.. | ❌ |
receiver_number |
str |
Phone number to receive the message (E.164 format, e.g., +15551234567). | ✅ |
message |
str |
Content of the message to be sent.. | ❌ |
message_parameters |
Dict[str, Union[bool, float, int, str]] |
Data to be used inside the message.. | ✅ |
message_parameters_operations |
Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]] |
Preprocessing operations to be performed on message parameters.. | ❌ |
media_url |
Optional[List[str], str] |
Optional media URL(s) for MMS. Provide publicly accessible image URLs or image outputs from workflow blocks.. | ✅ |
twilio_account_sid |
str |
Twilio Account SID from the Twilio Console.. | ✅ |
twilio_auth_token |
str |
Twilio Auth Token from the Twilio Console.. | ✅ |
sender_number |
str |
Sender phone number (E.164 format, e.g., +15551234567). | ✅ |
fire_and_forget |
bool |
Boolean flag to run the block asynchronously (True) for faster workflows or synchronously (False) for debugging and error handling.. | ✅ |
disable_sink |
bool |
Boolean flag to disable block execution.. | ✅ |
cooldown_seconds |
int |
Number of seconds until a follow-up notification can be sent.. | ✅ |
The Refs column marks possibility to parametrise the property with dynamic values available
in workflow runtime. See Bindings for more info.
Available Connections¶
Compatible Blocks
Check what blocks you can connect to Twilio SMS/MMS Notification in version v2.
- inputs:
Keypoint Detection Model,VLM As Detector,YOLO-World Model,MoonshotAI Kimi,Polygon Zone Visualization,OpenAI-Compatible LLM,Heatmap Visualization,Email Notification,Llama 3.2 Vision,Anthropic Claude,Camera Focus,Label Visualization,Path Deviation,Qwen3.5,SmolVLM2,Rate Limiter,Byte Tracker,Background Color Visualization,Mask Edge Snap,Moondream2,Velocity,Detection Event Log,Florence-2 Model,Barcode Detection,OCR Model,Single-Label Classification Model,VLM As Classifier,Qwen2.5-VL,Detections Stabilizer,LMM For Classification,SIFT,Roboflow Dataset Upload,Segment Anything 2 Model,Multi-Label Classification Model,Halo Visualization,Qwen3.5-VL,Qwen3-VL,Time in Zone,Stitch OCR Detections,Model Comparison Visualization,QR Code Detection,Detections Combine,Bounding Rectangle,ByteTrack Tracker,Stability AI Inpainting,Image Convert Grayscale,Line Counter,OpenAI,Llama 3.2 Vision,Anthropic Claude,Dynamic Crop,Size Measurement,Detections Consensus,Dominant Color,Continue If,Contrast Enhancement,Bounding Box Visualization,Depth Estimation,CLIP Embedding Model,EasyOCR,Relative Static Crop,Polygon Visualization,Google Gemma API,Qwen 3.6 API,Template Matching,Single-Label Classification Model,Image Blur,Anthropic Claude,Triangle Visualization,Roboflow Custom Metadata,Slack Notification,Image Stack,Pixelate Visualization,Image Slicer,Line Counter Visualization,Image Slicer,Cosine Similarity,Cache Get,Expression,Data Aggregator,Google Gemini,Camera Calibration,Ellipse Visualization,Identify Changes,GLM-OCR,Crop Visualization,Circle Visualization,Dimension Collapse,Webhook Sink,MoonshotAI Kimi,S3 Sink,Email Notification,Clip Comparison,Morphological Transformation,Path Deviation,Qwen-VL,SAM 3,Twilio SMS/MMS Notification,Line Counter,Time in Zone,Stitch OCR Detections,OpenAI,VLM As Detector,Keypoint Visualization,Seg Preview,Stability AI Image Generation,Google Vision OCR,SAM 3,Instance Segmentation Model,Overlap Filter,Local File Sink,Multi-Label Classification Model,Google Gemini,Motion Detection,Instance Segmentation Model,Qwen 3.5 API,Google Gemini,Polygon Visualization,Grid Visualization,SIFT Comparison,Delta Filter,Time in Zone,Detections Filter,Detections Merge,First Non Empty Or Default,Keypoint Detection Model,Image Preprocessing,Dynamic Zone,Corner Visualization,Stability AI Outpainting,Detections List Roll-Up,Blur Visualization,Semantic Segmentation Model,Property Definition,Perception Encoder Embedding Model,Distance Measurement,VLM As Classifier,Trace Visualization,Morphological Transformation,Gaze Detection,Reference Path Visualization,Halo Visualization,Dot Visualization,JSON Parser,Pixel Color Count,Background Subtraction,Text Display,Absolute Static Crop,CSV Formatter,Florence-2 Model,Byte Tracker,Icon Visualization,Identify Outliers,Mask Area Measurement,Object Detection Model,Perspective Correction,SAM 3,BoT-SORT Tracker,Object Detection Model,QR Code Generator,OpenRouter,Model Monitoring Inference Aggregator,Image Threshold,OC-SORT Tracker,Clip Comparison,Cache Set,Detection Offset,Keypoint Detection Model,Image Contours,Multi-Label Classification Model,Per-Class Confidence Filter,Object Detection Model,OpenAI,SIFT Comparison,Single-Label Classification Model,OpenAI,Stitch Images,Buffer,Instance Segmentation Model,Environment Secrets Store,Detections Classes Replacement,Semantic Segmentation Model,LMM,Roboflow Dataset Upload,Detections Transformation,Color Visualization,Classification Label Visualization,Camera Focus,Detections Stitch,Byte Tracker,PTZ Tracking (ONVIF),SORT Tracker,Mask Visualization,CogVLM,Inner Workflow,SAM2 Video Tracker,Contrast Equalization,Roboflow Vision Events,Twilio SMS Notification,Google Gemma - outputs:
S3 Sink,Email Notification,Keypoint Detection Model,Morphological Transformation,SAM 3,Path Deviation,Qwen-VL,Clip Comparison,Twilio SMS/MMS Notification,YOLO-World Model,Line Counter,Time in Zone,Polygon Zone Visualization,MoonshotAI Kimi,Stitch OCR Detections,OpenAI-Compatible LLM,OpenAI,Heatmap Visualization,Email Notification,Keypoint Visualization,Llama 3.2 Vision,Anthropic Claude,Stability AI Image Generation,Seg Preview,Google Vision OCR,Label Visualization,SAM 3,Instance Segmentation Model,Path Deviation,Local File Sink,Multi-Label Classification Model,Google Gemini,Motion Detection,Background Color Visualization,Instance Segmentation Model,Qwen 3.5 API,Google Gemini,Polygon Visualization,Moondream2,SIFT Comparison,Florence-2 Model,Time in Zone,Single-Label Classification Model,LMM For Classification,Keypoint Detection Model,Image Preprocessing,Roboflow Dataset Upload,Dynamic Zone,Corner Visualization,Segment Anything 2 Model,Stability AI Outpainting,Multi-Label Classification Model,Halo Visualization,Time in Zone,Semantic Segmentation Model,Blur Visualization,Perception Encoder Embedding Model,Distance Measurement,Morphological Transformation,Trace Visualization,Stitch OCR Detections,Gaze Detection,Reference Path Visualization,Halo Visualization,Model Comparison Visualization,Dot Visualization,Pixel Color Count,Text Display,Florence-2 Model,Icon Visualization,Object Detection Model,Perspective Correction,SAM 3,BoT-SORT Tracker,Stability AI Inpainting,Object Detection Model,Line Counter,QR Code Generator,OpenRouter,Model Monitoring Inference Aggregator,OpenAI,Llama 3.2 Vision,Image Threshold,Anthropic Claude,Dynamic Crop,Detections Consensus,Size Measurement,Cache Set,Bounding Box Visualization,Depth Estimation,Keypoint Detection Model,CLIP Embedding Model,Multi-Label Classification Model,Polygon Visualization,Google Gemma API,Template Matching,Qwen 3.6 API,Single-Label Classification Model,Image Blur,Anthropic Claude,Object Detection Model,Triangle Visualization,Roboflow Custom Metadata,OpenAI,Slack Notification,Image Stack,Pixelate Visualization,Single-Label Classification Model,OpenAI,Instance Segmentation Model,Line Counter Visualization,Detections Classes Replacement,Cache Get,LMM,Roboflow Dataset Upload,Color Visualization,Google Gemini,Classification Label Visualization,Camera Calibration,Detections Stitch,Ellipse Visualization,PTZ Tracking (ONVIF),Mask Visualization,GLM-OCR,Crop Visualization,Circle Visualization,CogVLM,Contrast Equalization,Roboflow Vision Events,Webhook Sink,Twilio SMS Notification,MoonshotAI Kimi,Google Gemma
Input and Output Bindings¶
The available connections depend on its binding kinds. Check what binding kinds
Twilio SMS/MMS Notification in version v2 has.
Bindings
-
input
receiver_number(string): Phone number to receive the message (E.164 format, e.g., +15551234567).message_parameters(*): Data to be used inside the message..media_url(Union[list_of_values,string,image]): Optional media URL(s) for MMS. Provide publicly accessible image URLs or image outputs from workflow blocks..twilio_account_sid(Union[string,secret]): Twilio Account SID from the Twilio Console..twilio_auth_token(Union[string,secret]): Twilio Auth Token from the Twilio Console..sender_number(string): Sender phone number (E.164 format, e.g., +15551234567).fire_and_forget(boolean): Boolean flag to run the block asynchronously (True) for faster workflows or synchronously (False) for debugging and error handling..disable_sink(boolean): Boolean flag to disable block execution..cooldown_seconds(integer): Number of seconds until a follow-up notification can be sent..
-
output
Example JSON definition of step Twilio SMS/MMS Notification in version v2
{
"name": "<your_step_name_here>",
"type": "roboflow_core/twilio_sms_notification@v2",
"sms_provider": "Roboflow Managed API Key",
"receiver_number": "+15551234567",
"message": "Alert! Detected {{ '{{' }} $parameters.num_detections {{ '}}' }} objects",
"message_parameters": {
"num_detections": "$steps.model.predictions",
"reference": "$inputs.reference_class_names"
},
"message_parameters_operations": {
"predictions": [
{
"property_name": "class_name",
"type": "DetectionsPropertyExtract"
}
]
},
"media_url": "$steps.visualization.image",
"twilio_account_sid": "$inputs.twilio_account_sid",
"twilio_auth_token": "$inputs.twilio_auth_token",
"sender_number": "+15551234567",
"fire_and_forget": "$inputs.fire_and_forget",
"disable_sink": false,
"cooldown_seconds": "$inputs.cooldown_seconds"
}