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.