Skip to main content

Twilio alerts

Send kwatch incident alerts to Twilio. Use the interactive manager for installation and credential setup. This page explains the provider fields and shows a minimal configuration fragment.

Before you start, have these values ready:

  • accountSid — Account SID.
  • authToken — Auth token.
  • from — Sender phone number.
  • to — Recipient phone number.

Credentials, tokens, keys, passwords, and webhook URLs must be mounted from a Kubernetes Secret. Use an exact ${file:/absolute/path} reference for every field marked Secret.

Configuration​

FieldTypeRequiredSecretValidationDefaultDescription
accountSidstringyesyes——Account SID
authTokenstringyesyes——Auth token
fromstringyesno——Sender phone number
tostringyesno——Recipient phone number
routesjsonnonojson—Optional JSON route filters.
retry.maxAttemptsintegernonointeger—Optional maximum retry attempts.
retry.delaystringnono——Optional retry delay, for example 5s.
fallbackstringnono——Optional fallback provider name.

Minimal example​

alert:
twilio:
accountSid: "${file:/config/twilio-accountSid}"
authToken: "${file:/config/twilio-authToken}"
from: <from>
to: <to>

Add routes, retry, and fallback when you need delivery filtering or recovery. See the channels overview for guidance, or the complete provider reference for the catalog-wide view.