Twilio Send

Twilio Send

Certified

Send an SMS via Twilio Programmable Messaging

Posts a message to the Twilio Messages API using Account SID and Auth Token for basic authentication. Returns the Twilio message SID and delivery status from the API response. See the Twilio documentation for details.

yaml
type: io.kestra.plugin.twilio.notify.sms.Send

Send an SMS on a failed flow execution.

yaml
id: sms_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.sms.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 }}."

Send an SMS message.

yaml
id: send_sms
namespace: company.team

tasks:
  - id: send_sms
    type: io.kestra.plugin.twilio.notify.sms.Send
    accountSID: "{{ secret('TWILIO_ACCOUNT_SID') }}"
    authToken: "{{ secret('TWILIO_AUTH_TOKEN') }}"
    from: "{{ secret('TWILIO_FROM_NUMBER') }}"
    to: "+15555550100"
    body: "Hello from Kestra."
Properties

Twilio Account SID

The Account SID used for basic authentication and to construct the Messages API URL

Twilio Auth Token

The Auth Token paired with the Account SID; store as a Kestra secret

Message body

The text content of the message

Sender phone number or Messaging Service SID

The Twilio number or Messaging Service SID to send from

Recipient phone number

The destination phone number in E.164 format, e.g. +15555550100

Options

Optional HTTP client overrides for timeouts, charset, headers, and max content length

Definitions
connectTimeoutstring

Connect timeout

Time allowed to establish the HTTP connection before failing

connectionPoolIdleTimeoutstring
DefaultPT0S

Connection pool idle timeout

Time an idle pooled connection stays open before closing; defaults to 0s (no TTL)

defaultCharsetstring
DefaultUTF-8

Default request charset

Charset applied to requests when not specified; defaults to UTF-8

headersobject

HTTP headers

HTTP headers to include in the request

maxContentLengthintegerstring
Default10485760

Max response size

Maximum response content length in bytes; defaults to 10MB

readIdleTimeoutstring
DefaultPT5M

Read idle timeout

How long a read connection may stay idle before closing; defaults to 5m

readTimeoutstring
DefaultPT10S

Read timeout

Maximum time to read data before failing; defaults to 10s

Reference (ref) of the pluginDefaults to apply to this task.

Twilio message SID

Unique identifier assigned by Twilio to the sent message

Message status

Delivery status returned by Twilio, e.g. queued, sent, delivered

More Plugins in this Category

PostgreSQL
PostgreSQL

Tasks that connect to PostgreSQL via JDBC to run queries and loads.

Data

6 tasks

25 blueprints

Dataform
Dataform

Tasks that run Dataform data transformations through the Dataform CLI.

Data

1 tasks

6 blueprints