Twilio TwilioAlert
CertifiedSend a Twilio Notify message
Twilio TwilioAlert
Send a Twilio Notify message
Post a payload to the Twilio Notify API using the provided service URL with Account SID/Auth Token basic auth. Use in errors handlers for flow-level alerts; for Flow-triggered execution summaries, prefer TwilioExecution. See the Twilio documentation for payload details.
type: io.kestra.plugin.twilio.notify.TwilioAlertExamples
Send a Twilio notification on a failed flow execution.
id: unreliable_flow
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.TwilioAlert
url: "{{ secret('TWILIO_NOTIFICATION_URL') }}" # https://notify.twilio.com/v1/Services/ISXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Notifications
accountSID: "{{ secret('TWILIO_ACCOUNT_SID') }}"
authToken: "{{ secret('TWILIO_AUTH_TOKEN') }}"
payload: |
{
"identity": "0000001"
}
Send a Twilio message via incoming notification API.
id: twilio_alert
namespace: company.team
tasks:
- id: send_twilio_message
type: io.kestra.plugin.twilio.notify.TwilioAlert
url: "{{ secret('TWILIO_NOTIFICATION_URL') }}"
accountSID: "{{ secret('TWILIO_ACCOUNT_SID') }}"
authToken: "{{ secret('TWILIO_AUTH_TOKEN') }}"
payload: |
{
"identity": "0000001"
}
Properties
accountSID *Requiredstring
1Twilio Account SID
Used with authToken for HTTP basic authentication
authToken *Requiredstring
1Twilio Auth Token
Secret token paired with the Account SID; store as a secret
url *Requiredstring
1Twilio Notify service URL
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
payload string
Notify payload body
Raw JSON payload sent to Twilio; overrides templated fields when provided
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
