
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 *string
1Twilio Account SID
Used with authToken for HTTP basic authentication
authToken *string
1Twilio Auth Token
Secret token paired with the Account SID; store as a secret
url *string
1Twilio Notify service URL
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150options
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