
Twilio Send
CertifiedSend an MMS via Twilio Programmable Messaging
Twilio Send
Send an MMS via Twilio Programmable Messaging
Posts a multimedia message to the Twilio Messages API using Account SID and Auth Token for basic authentication. Supports one or more media URLs attached to the message. Returns the Twilio message SID and delivery status from the API response. See the Twilio documentation for details.
type: io.kestra.plugin.twilio.notify.mms.SendExamples
Send an MMS on a failed flow execution.
id: mms_on_failure
namespace: company.team
tasks:
- id: fail
type: io.kestra.plugin.scripts.shell.Commands
runner: PROCESS
commands:
- exit 1
errors:
- id: alert_on_failure
type: io.kestra.plugin.twilio.notify.mms.Send
accountSID: "{{ secret('TWILIO_ACCOUNT_SID') }}"
authToken: "{{ secret('TWILIO_AUTH_TOKEN') }}"
from: "{{ secret('TWILIO_FROM_NUMBER') }}"
to: "+15555550100"
body: "Flow {{ flow.id }} failed on execution {{ execution.id }}."
mediaUrls:
- "https://demo.twilio.com/owl.png"
Send an MMS message with one media attachment.
id: send_mms
namespace: company.team
tasks:
- id: send_mms
type: io.kestra.plugin.twilio.notify.mms.Send
accountSID: "{{ secret('TWILIO_ACCOUNT_SID') }}"
authToken: "{{ secret('TWILIO_AUTH_TOKEN') }}"
from: "{{ secret('TWILIO_FROM_NUMBER') }}"
to: "+15555550100"
body: "Here is your report."
mediaUrls:
- "https://example.com/report.png"
Properties
accountSID *Requiredstring
Twilio Account SID
The Account SID used for basic authentication and to construct the Messages API URL
authToken *Requiredstring
Twilio Auth Token
The Auth Token paired with the Account SID; store as a Kestra secret
body *Requiredstring
Message body
The text content of the message
from *Requiredstring
Sender phone number or Messaging Service SID
The Twilio number or Messaging Service SID to send from
mediaUrls *Requiredarray
Media URLs
One or more publicly accessible URLs for media to attach; Twilio accepts up to 10 per message
to *Requiredstring
Recipient phone number
The destination phone number in E.164 format, e.g. +15555550100
options
Options
Optional HTTP client overrides for timeouts, charset, headers, and max content length
io.kestra.plugin.twilio.AbstractTwilioConnection-RequestOptions
Connect timeout
Time allowed to establish the HTTP connection before failing
PT0SConnection pool idle timeout
Time an idle pooled connection stays open before closing; defaults to 0s (no TTL)
UTF-8Default request charset
Charset applied to requests when not specified; defaults to UTF-8
java.nio.charset.Charset
HTTP headers
HTTP headers to include in the request
10485760Max response size
Maximum response content length in bytes; defaults to 10MB
PT5MRead idle timeout
How long a read connection may stay idle before closing; defaults to 5m
PT10SRead timeout
Maximum time to read data before failing; defaults to 10s
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
Outputs
sid string
Twilio message SID
Unique identifier assigned by Twilio to the sent message
status string
Message status
Delivery status returned by Twilio, e.g. queued, sent, delivered