# OnCallAlert Runtime Configuration Reference

This document is the authoritative reference for OnCallAlert's runtime configuration. It defines all **17 categories** and **91 parameters** exposed by the system.

- **JSON Schema**: Available in [`config.json`](https://oncallalert.dev/schemas/config.json) adhering to the standard JSON Schema Draft-07 specification.
- **Hierarchy**: Configuration is structured hierarchically. At the root are 17 category objects (`General`, `Alerts`, `Twilio`, etc.). Inside each category object are the individual parameters.
- **Identifier Convention**: When interacting through GraphQL or flat configuration maps, parameters are referenced using dot notation: `<Category>.<Parameter>` (e.g. `General.ApplicationName`, `Alerts.HighPriorityEscalationDelayMinutes`).

## Management Interfaces

OnCallAlert provides multiple interfaces for inspecting and modifying configuration:

### 1. CLI Commands

The server binary includes `get-config` and `set-config` subcommands for administrative automation.

#### Retrieving Configuration (`get-config`)

Outputs the complete active runtime configuration as JSON to `stdout`:

```bash
# Export current configuration to a file
oncallalert get-config --db-url "postgres://..." > config.json
```

#### Updating Configuration (`set-config`)

Applies configuration changes to the database from standard input or the `--data` flag in a single transaction:

```bash
# Pipe a modified JSON configuration file into set-config
cat config.json | oncallalert set-config --db-url "postgres://..."

# Or pass an inline JSON snippet
oncallalert set-config \
  --db-url "postgres://..." \
  --data '{"Alerts": {"HighPriorityEscalationDelayMinutes": 10}}'
```

### 2. GraphQL Mutation API

Administrators can read and mutate configuration parameters through the GraphQL API.

#### Querying Configuration (`query GetConfig`)

```graphql
query GetConfig {
  config {
    id
    description
    value
    type
    password
    deprecated
  }
}
```

#### Updating Configuration (`mutation SetConfig`)

```graphql
mutation SetConfig($input: [ConfigValueInput!]) {
  setConfig(input: $input)
}
```

Variables payload example:

```json
{
  "input": [
    {
      "id": "General.ApplicationName",
      "value": "Acme SRE On-Call"
    },
    {
      "id": "Alerts.HighPriorityEscalationDelayMinutes",
      "value": "10"
    },
    {
      "id": "Maintenance.AlertAutoCloseDays",
      "value": "14"
    }
  ]
}
```

### 3. REST HTTP Endpoints

- `GET /api/v2/config`: Downloads the current configuration file as JSON.
- `PUT /api/v2/config`: Replaces the configuration payload and triggers an immediate reload.

## Table of Categories

- [AI](#ai) (6 parameters) — AI alert triage and automated LLM summary generation settings.
- [Alerts](#alerts) (6 parameters) — Alert priority labeling, escalation delays, deduplication windows, and notification contact settings.
- [Auth](#auth) (2 parameters) — User authentication, referer URLs, and basic authentication settings.
- [Deadman](#deadman) (3 parameters) — Deadman contains configuration for the SaaS dead-man switch heartbeat (see docs/superpowers/specs/2026-11-08-deadman-heartbeat-design.md).
- [Feedback](#feedback) (2 parameters) — User feedback link and navigation bar settings.
- [General](#general) (9 parameters) — General application settings such as application name, public URL, analytics, and messaging behavior.
- [GitHub](#github) (7 parameters) — GitHub OAuth authentication, allowed organizations, and user whitelist settings.
- [Mailgun](#mailgun) (3 parameters) — Mailgun API key and incoming email domain ingress configuration.
- [Maintenance](#maintenance) (5 parameters) — Retention policies and automated cleanup intervals for alerts, calendar keys, and schedule history.
- [Mobile](#mobile) (3 parameters) — Mobile contains configuration for connecting to the project owner's mobile push relay (see docs/superpowers/specs/2026-08-13-mobile-app-relay-design.md).
- [OIDC](#oidc) (10 parameters) — OpenID Connect (OIDC) single sign-on authentication and claim mappings.
- [SMTP](#smtp) (7 parameters) — Outgoing email (SMTP) server connection and authentication configuration.
- [Services](#services) (1 parameters) — Service configuration and required label definitions for services.
- [Slack](#slack) (7 parameters) — Slack workspace integration, bot OAuth credentials, signing secrets, and channel broadcast behavior.
- [Twilio](#twilio) (14 parameters) — Twilio voice and SMS telephony notification provider settings.
- [WebPush](#webpush) (4 parameters) — WebPush contains configuration for browser push notifications (VAPID).
- [Webhook](#webhook) (2 parameters) — Webhook notification settings and allowed destination URL patterns.

---

## Category Reference

### AI

AI alert triage and automated LLM summary generation settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AutoTriage` | `AI.AutoTriage` | `bool` | `false` | — | Summarize every new alert automatically. Off by default: users click Ask AI on an alert instead, so alerts they already understand cost nothing. |
| `BaseURL` | `AI.BaseURL` | `string` | `""` | — | API base URL. Required for openai-compatible; optional override for the others. |
| `Enable` | `AI.Enable` | `bool` | `false` | `Public` | Turn on Ask AI with your own LLM. Alert text is sent to the provider you choose whenever a summary is generated. |
| `MaxPerHour` | `AI.MaxPerHour` | `int` | `30` | — | Maximum triages per hour, to cap cost during alert storms. 0 means 30. |
| `Model` | `AI.Model` | `string` | `""` | — | Model name to use, e.g. gpt-4o-mini or claude-haiku-5-5. |
| `Provider` | `AI.Provider` | `string` | `""` | — | LLM provider: openai, anthropic, ollama or openai-compatible. |

#### Example JSON

```json
{
  "AI": {
    "AutoTriage": false,
    "BaseURL": "",
    "Enable": false,
    "MaxPerHour": 30,
    "Model": "",
    "Provider": ""
  }
}
```

### Alerts

Alert priority labeling, escalation delays, deduplication windows, and notification contact settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AllowSameTypeContactMethods` | `Alerts.AllowSameTypeContactMethods` | `bool` | `false` | `Public` | Allow notifying more than one contact method of the same type (e.g. two phone numbers) for one alert. |
| `HighPriorityDedupeWindowMinutes` | `Alerts.HighPriorityDedupeWindowMinutes` | `int` | `2` | `Public` | For high priority alerts, the same contact method is not notified twice within this many minutes (empty means 2, -1 turns it off). |
| `HighPriorityEscalationContactTypes` | `Alerts.HighPriorityEscalationContactTypes` | `[]string` | `[]` | `Public` | Contact types (voice, sms, mobile, email, slack, webpush) notified when a high priority alert is still unacknowledged after the escalation delay. Leave empty for no escalation. |
| `HighPriorityEscalationDelayMinutes` | `Alerts.HighPriorityEscalationDelayMinutes` | `int` | `5` | `Public` | Minutes a high priority alert may stay unacknowledged before the escalation is sent. Minimum 1; empty or 0 means 5. Do not set it very low: the user gets no time to acknowledge and everything fires at once. |
| `HighPriorityLabelKey` | `Alerts.HighPriorityLabelKey` | `string` | `""` | `Public` | Label key used to mark high priority alerts. |
| `HighPriorityLabelValue` | `Alerts.HighPriorityLabelValue` | `string` | `""` | `Public` | Label value indicating high priority alerts. |

#### Example JSON

```json
{
  "Alerts": {
    "AllowSameTypeContactMethods": false,
    "HighPriorityDedupeWindowMinutes": 2,
    "HighPriorityEscalationContactTypes": [],
    "HighPriorityEscalationDelayMinutes": 5,
    "HighPriorityLabelKey": "",
    "HighPriorityLabelValue": ""
  }
}
```

### Auth

User authentication, referer URLs, and basic authentication settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `DisableBasic` | `Auth.DisableBasic` | `bool` | `false` | `Public` | Disallow username/password login. |
| `RefererURLs` | `Auth.RefererURLs` | `[]string` | `[]` | `⚠️ Deprecated` | Allowed referer URLs for auth and redirects. *(Deprecated: Use --public-url flag instead, which takes precedence.)* |

#### Example JSON

```json
{
  "Auth": {
    "DisableBasic": false,
    "RefererURLs": []
  }
}
```

### Deadman

Deadman contains configuration for the SaaS dead-man switch heartbeat (see docs/superpowers/specs/2026-11-08-deadman-heartbeat-design.md).

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `Enable` | `Deadman.Enable` | `bool` | `false` | `Public` | Enable the SaaS dead-man switch: the server pings heartbeat.oncallalert.dev on a timer; if pings stop, admin phones receive a push notification. |
| `IntervalSeconds` | `Deadman.IntervalSeconds` | `int` | `300` | `Public` | How often (in seconds) to send a heartbeat ping. Must be between 300 and 3600. Default: 300. |
| `MissCount` | `Deadman.MissCount` | `int` | `3` | `Public` | How many consecutive missed pings before an outage is declared. Must be between 1 and 10. Default: 3. |

#### Example JSON

```json
{
  "Deadman": {
    "Enable": false,
    "IntervalSeconds": 300,
    "MissCount": 3
  }
}
```

### Feedback

User feedback link and navigation bar settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `Enable` | `Feedback.Enable` | `bool` | `false` | `Public` | Enables Feedback link in nav bar. |
| `OverrideURL` | `Feedback.OverrideURL` | `string` | `""` | `Public` | Use a custom URL for Feedback link in nav bar. |

#### Example JSON

```json
{
  "Feedback": {
    "Enable": false,
    "OverrideURL": ""
  }
}
```

### General

General application settings such as application name, public URL, analytics, and messaging behavior.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `ApplicationName` | `General.ApplicationName` | `string` | `"OnCallAlert"` | `Public` | The name used in messaging and page titles. Defaults to "OnCallAlert". |
| `DisableCalendarSubscriptions` | `General.DisableCalendarSubscriptions` | `bool` | `false` | `Public` | If set, disables all active calendar subscriptions as well as the ability to create new calendar subscriptions. |
| `DisableLabelCreation` | `General.DisableLabelCreation` | `bool` | `false` | `Public` | Disables the ability to create new labels for services. |
| `DisableMessageBundles` | `General.DisableMessageBundles` | `bool` | `false` | `Public` | Disable bundling status updates and alert notifications. |
| `DisableSMSLinks` | `General.DisableSMSLinks` | `bool` | `false` | `Public` | If set, SMS messages will not contain a URL pointing to OnCallAlert. |
| `GoogleAnalyticsID` | `General.GoogleAnalyticsID` | `string` | `""` | `Public` | If set, will post user metrics to the corresponding data stream in Google Analytics 4. |
| `NotificationDisclaimer` | `General.NotificationDisclaimer` | `string` | `""` | `Public` | Disclaimer text for receiving pre-recorded notifications (appears on profile page). |
| `PublicURL` | `General.PublicURL` | `string` | `""` | `⚠️ Deprecated` `Public` | Publicly routable URL for UI links and API calls. *(Deprecated: Use --public-url flag instead, which takes precedence.)* |
| `ShortURL` | `General.ShortURL` | `string` | `""` | `Public` | If set, messages will contain a shorter URL using this as a prefix (e.g. http://example.com). It should point to OnCallAlert and can be the same as the PublicURL. |

#### Example JSON

```json
{
  "General": {
    "ApplicationName": "OnCallAlert",
    "DisableCalendarSubscriptions": false,
    "DisableLabelCreation": false,
    "DisableMessageBundles": false,
    "DisableSMSLinks": false,
    "GoogleAnalyticsID": "",
    "NotificationDisclaimer": "",
    "PublicURL": "",
    "ShortURL": ""
  }
}
```

### GitHub

GitHub OAuth authentication, allowed organizations, and user whitelist settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AllowedOrgs` | `GitHub.AllowedOrgs` | `[]string` | `[]` | — | Allow any member of any listed GitHub org (or team, using the format 'org/team') to authenticate. |
| `AllowedUsers` | `GitHub.AllowedUsers` | `[]string` | `[]` | — | Allow any of the listed GitHub usernames to authenticate. Use '*' to allow any user. |
| `ClientID` | `GitHub.ClientID` | `string` | `""` | — | GitHub OAuth application client ID. |
| `ClientSecret` | `GitHub.ClientSecret` | `string` | `"" (secret)` | `🔒 Secret` | GitHub OAuth application client secret. |
| `Enable` | `GitHub.Enable` | `bool` | `false` | `Public` | Enable GitHub authentication. |
| `EnterpriseURL` | `GitHub.EnterpriseURL` | `string` | `""` | — | GitHub URL (without /api) when used with GitHub Enterprise. |
| `NewUsers` | `GitHub.NewUsers` | `bool` | `false` | — | Allow new user creation via GitHub authentication. |

#### Example JSON

```json
{
  "GitHub": {
    "AllowedOrgs": [],
    "AllowedUsers": [],
    "ClientID": "",
    "ClientSecret": "",
    "Enable": false,
    "EnterpriseURL": "",
    "NewUsers": false
  }
}
```

### Mailgun

Mailgun API key and incoming email domain ingress configuration.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `APIKey` | `Mailgun.APIKey` | `string` | `"" (secret)` | `🔒 Secret` | Set this to the HTTP webhook signing key. |
| `EmailDomain` | `Mailgun.EmailDomain` | `string` | `""` | — | The TO address for all incoming alerts. |
| `Enable` | `Mailgun.Enable` | `bool` | `false` | `Public` | Enables Mailgun as an email notification and ingress provider. |

#### Example JSON

```json
{
  "Mailgun": {
    "APIKey": "",
    "EmailDomain": "",
    "Enable": false
  }
}
```

### Maintenance

Retention policies and automated cleanup intervals for alerts, calendar keys, and schedule history.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `APIKeyExpireDays` | `Maintenance.APIKeyExpireDays` | `int` | `0` | `Public` | Unused calendar API keys will be disabled after this many days (0 means disable cleanup). |
| `AlertAutoCloseDays` | `Maintenance.AlertAutoCloseDays` | `int` | `0` | `Public` | Unacknowledged alerts will automatically be closed after this many days of inactivity. (0 means disable auto-close). |
| `AlertCleanupDays` | `Maintenance.AlertCleanupDays` | `int` | `0` | `Public` | Closed alerts will be deleted after this many days (0 means disable cleanup). |
| `AutoCloseAckedAlerts` | `Maintenance.AutoCloseAckedAlerts` | `bool` | `false` | `Public` | If set, alerts that are acknowledged will also be automatically closed after the configured number of days of inactivity. |
| `ScheduleCleanupDays` | `Maintenance.ScheduleCleanupDays` | `int` | `0` | `Public` | Schedule on-call history will be deleted after this many days (0 means disable cleanup). |

#### Example JSON

```json
{
  "Maintenance": {
    "APIKeyExpireDays": 0,
    "AlertAutoCloseDays": 0,
    "AlertCleanupDays": 0,
    "AutoCloseAckedAlerts": false,
    "ScheduleCleanupDays": 0
  }
}
```

### Mobile

Mobile contains configuration for connecting to the project owner's mobile push relay (see docs/superpowers/specs/2026-08-13-mobile-app-relay-design.md).

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `Enable` | `Mobile.Enable` | `bool` | `false` | `Public` | Enable native mobile app push notifications via the OnCallAlert Relay. |
| `RelayAPIKey` | `Mobile.RelayAPIKey` | `string` | `"" (secret)` | `🔒 Secret` | API key issued for this instance by the relay operator. |
| `RelayURL` | `Mobile.RelayURL` | `string` | `""` | `Public` | Base URL of the OnCallAlert Relay (e.g. https://relay.oncallalert.dev). |

#### Example JSON

```json
{
  "Mobile": {
    "Enable": false,
    "RelayAPIKey": "",
    "RelayURL": ""
  }
}
```

### OIDC

OpenID Connect (OIDC) single sign-on authentication and claim mappings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `ClientID` | `OIDC.ClientID` | `string` | `""` | — | OpenID Connect client ID. |
| `ClientSecret` | `OIDC.ClientSecret` | `string` | `"" (secret)` | `🔒 Secret` | OpenID Connect client secret. |
| `Enable` | `OIDC.Enable` | `bool` | `false` | `Public` | Enable OpenID Connect authentication. |
| `IssuerURL` | `OIDC.IssuerURL` | `string` | `""` | — | OpenID Connect provider issuer URL. |
| `NewUsers` | `OIDC.NewUsers` | `bool` | `false` | — | Allow new user creation via OIDC authentication. |
| `OverrideName` | `OIDC.OverrideName` | `string` | `""` | — | Set the name/label on the login page to something other than OIDC. |
| `Scopes` | `OIDC.Scopes` | `string` | `""` | — | Requested scopes for authentication. If left blank, openid, profile, and email will be used. |
| `UserInfoEmailPath` | `OIDC.UserInfoEmailPath` | `string` | `""` | — | JMESPath expression to find email address in UserInfo. If set, the email claim will be ignored in favor of this. (suggestion: email). |
| `UserInfoEmailVerifiedPath` | `OIDC.UserInfoEmailVerifiedPath` | `string` | `""` | — | JMESPath expression to find email verification state in UserInfo. If set, the email_verified claim will be ignored in favor of this. (suggestion: email_verified). |
| `UserInfoNamePath` | `OIDC.UserInfoNamePath` | `string` | `""` | — | JMESPath expression to find full name in UserInfo. If set, the name claim will be ignored in favor of this. (suggestion: name || cn || join(' ', [firstname, lastname])) |

#### Example JSON

```json
{
  "OIDC": {
    "ClientID": "",
    "ClientSecret": "",
    "Enable": false,
    "IssuerURL": "",
    "NewUsers": false,
    "OverrideName": "",
    "Scopes": "",
    "UserInfoEmailPath": "",
    "UserInfoEmailVerifiedPath": "",
    "UserInfoNamePath": ""
  }
}
```

### SMTP

Outgoing email (SMTP) server connection and authentication configuration.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `Address` | `SMTP.Address` | `string` | `""` | — | The server address to use for sending email. Port is optional and defaults to 465, or 25 if Disable TLS is set. Common ports are: 25 or 587 for STARTTLS (or unencrypted) and 465 for TLS. |
| `DisableTLS` | `SMTP.DisableTLS` | `bool` | `false` | — | Disables TLS on the connection (STARTTLS will still be used if supported). |
| `Enable` | `SMTP.Enable` | `bool` | `false` | `Public` | Enables email as a contact method. |
| `From` | `SMTP.From` | `string` | `""` | `Public` | The email address messages should be sent from. |
| `Password` | `SMTP.Password` | `string` | `"" (secret)` | `🔒 Secret` | Password for authentication. |
| `SkipVerify` | `SMTP.SkipVerify` | `bool` | `false` | — | Disables certificate validation for TLS/STARTTLS (insecure). |
| `Username` | `SMTP.Username` | `string` | `""` | — | Username for authentication. |

#### Example JSON

```json
{
  "SMTP": {
    "Address": "",
    "DisableTLS": false,
    "Enable": false,
    "From": "",
    "Password": "",
    "SkipVerify": false,
    "Username": ""
  }
}
```

### Services

Service configuration and required label definitions for services.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `RequiredLabels` | `Services.RequiredLabels` | `[]string` | `[]` | `Public` | List of label names to require new services to define. |

#### Example JSON

```json
{
  "Services": {
    "RequiredLabels": []
  }
}
```

### Slack

Slack workspace integration, bot OAuth credentials, signing secrets, and channel broadcast behavior.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AccessToken` | `Slack.AccessToken` | `string` | `"" (secret)` | `🔒 Secret` | Slack app bot user OAuth access token (should start with xoxb-). |
| `ClientID` | `Slack.ClientID` | `string` | `""` | — | Slack application client ID. |
| `ClientSecret` | `Slack.ClientSecret` | `string` | `"" (secret)` | `🔒 Secret` | Slack application client secret. |
| `DisableBroadcastThreadReplies` | `Slack.DisableBroadcastThreadReplies` | `bool` | `false` | `Public` | Disable broadcasting alert status updates in threads to the main channel. |
| `Enable` | `Slack.Enable` | `bool` | `false` | `Public` | Enables Slack workspace integration for notifications and interactive alerts. |
| `InteractiveMessages` | `Slack.InteractiveMessages` | `bool` | `false` | — | Enable interactive messages (e.g. buttons). |
| `SigningSecret` | `Slack.SigningSecret` | `string` | `"" (secret)` | `🔒 Secret` | Signing secret to verify requests from slack. |

#### Example JSON

```json
{
  "Slack": {
    "AccessToken": "",
    "ClientID": "",
    "ClientSecret": "",
    "DisableBroadcastThreadReplies": false,
    "Enable": false,
    "InteractiveMessages": false,
    "SigningSecret": ""
  }
}
```

### Twilio

Twilio voice and SMS telephony notification provider settings.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AccountSID` | `Twilio.AccountSID` | `string` | `""` | — | Twilio Account SID used for API authentication. |
| `AlternateAuthToken` | `Twilio.AlternateAuthToken` | `string` | `"" (secret)` | `🔒 Secret` | An alternate Auth Token for validating incoming requests. During a key change, set this to the Primary, and Auth Token to the Secondary, then promote and clear this field. |
| `AuthToken` | `Twilio.AuthToken` | `string` | `"" (secret)` | `🔒 Secret` | The primary Auth Token for Twilio. Must be primary unless Alternate Auth Token is set. This token is used for outgoing requests. |
| `DisableCallProcessing` | `Twilio.DisableCallProcessing` | `bool` | `false` | `Public` | Disables all call processing. |
| `DisableSMSContactMethod` | `Twilio.DisableSMSContactMethod` | `bool` | `false` | `Public` | Disables SMS as a contact method option for users. |
| `DisableTwoWaySMS` | `Twilio.DisableTwoWaySMS` | `bool` | `false` | — | Disables SMS reply codes for alert messages. |
| `Enable` | `Twilio.Enable` | `bool` | `false` | `Public` | Enables sending and processing of Voice and SMS messages through the Twilio notification provider. |
| `FromNumber` | `Twilio.FromNumber` | `string` | `""` | `Public` | The Twilio number to use for outgoing notifications. |
| `MessagingServiceSID` | `Twilio.MessagingServiceSID` | `string` | `""` | `Public` | If set, replaces the use of From Number for SMS notifications. |
| `RCSSenderID` | `Twilio.RCSSenderID` | `string` | `""` | — | The sender ID for RCS messages. Required if RCS is enabled for the MessagingServiceSID. |
| `SMSCarrierLookup` | `Twilio.SMSCarrierLookup` | `bool` | `false` | — | Perform carrier lookup of SMS contact methods (required for SMSFromNumberOverride). Extra charges may apply. |
| `SMSFromNumberOverride` | `Twilio.SMSFromNumberOverride` | `[]string` | `[]` | — | List of 'carrier=number' pairs, SMS messages to numbers of the provided carrier string (exact match) will use the alternate From Number. |
| `VoiceLanguage` | `Twilio.VoiceLanguage` | `string` | `""` | — | The Twilio voice language to use for Text To Speech for phone calls. See https://www.twilio.com/docs/voice/twiml/say/text-speech#polly-standard-and-neural-voices |
| `VoiceName` | `Twilio.VoiceName` | `string` | `""` | — | The Twilio voice to use for Text To Speech for phone calls. See https://www.twilio.com/docs/voice/twiml/say/text-speech#polly-standard-and-neural-voices |

#### Example JSON

```json
{
  "Twilio": {
    "AccountSID": "",
    "AlternateAuthToken": "",
    "AuthToken": "",
    "DisableCallProcessing": false,
    "DisableSMSContactMethod": false,
    "DisableTwoWaySMS": false,
    "Enable": false,
    "FromNumber": "",
    "MessagingServiceSID": "",
    "RCSSenderID": "",
    "SMSCarrierLookup": false,
    "SMSFromNumberOverride": [],
    "VoiceLanguage": "",
    "VoiceName": ""
  }
}
```

### WebPush

WebPush contains configuration for browser push notifications (VAPID).

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `Enable` | `WebPush.Enable` | `bool` | `false` | `Public` | Enable Web Push notifications (requires VAPID keys). |
| `SubscriberEmail` | `WebPush.SubscriberEmail` | `string` | `""` | `Public` | Email address used for the VAPID contact (sub) claim. |
| `VAPIDPrivateKey` | `WebPush.VAPIDPrivateKey` | `string` | `"" (secret)` | `🔒 Secret` | Private VAPID key used for signing push messages (keep secret). |
| `VAPIDPublicKey` | `WebPush.VAPIDPublicKey` | `string` | `""` | `Public` | Public VAPID key (Base64 URL-safe, unpadded) exposed to clients. |

#### Example JSON

```json
{
  "WebPush": {
    "Enable": false,
    "SubscriberEmail": "",
    "VAPIDPrivateKey": "",
    "VAPIDPublicKey": ""
  }
}
```

### Webhook

Webhook notification settings and allowed destination URL patterns.

| Parameter | Full ID | Type | Default | Flags | Description |
|:---|:---|:---|:---|:---|:---|
| `AllowedURLs` | `Webhook.AllowedURLs` | `[]string` | `[]` | `Public` | If set, allows webhooks for these domains only. |
| `Enable` | `Webhook.Enable` | `bool` | `false` | `Public` | Enables webhook as a contact method. |

#### Example JSON

```json
{
  "Webhook": {
    "AllowedURLs": [],
    "Enable": false
  }
}
```

## Full Parameter Index

Quick lookup index of all 91 parameters:

| Full ID | Category | Type | Default | Sensitive |
|:---|:---|:---|:---|:---:|
| `AI.AutoTriage` | [AI](#ai) | `bool` | `false` | No |
| `AI.BaseURL` | [AI](#ai) | `string` | `""` | No |
| `AI.Enable` | [AI](#ai) | `bool` | `false` | No |
| `AI.MaxPerHour` | [AI](#ai) | `int` | `30` | No |
| `AI.Model` | [AI](#ai) | `string` | `""` | No |
| `AI.Provider` | [AI](#ai) | `string` | `""` | No |
| `Alerts.AllowSameTypeContactMethods` | [Alerts](#alerts) | `bool` | `false` | No |
| `Alerts.HighPriorityDedupeWindowMinutes` | [Alerts](#alerts) | `int` | `2` | No |
| `Alerts.HighPriorityEscalationContactTypes` | [Alerts](#alerts) | `[]string` | `[]` | No |
| `Alerts.HighPriorityEscalationDelayMinutes` | [Alerts](#alerts) | `int` | `5` | No |
| `Alerts.HighPriorityLabelKey` | [Alerts](#alerts) | `string` | `""` | No |
| `Alerts.HighPriorityLabelValue` | [Alerts](#alerts) | `string` | `""` | No |
| `Auth.DisableBasic` | [Auth](#auth) | `bool` | `false` | No |
| `Auth.RefererURLs` | [Auth](#auth) | `[]string` | `[]` | No |
| `Deadman.Enable` | [Deadman](#deadman) | `bool` | `false` | No |
| `Deadman.IntervalSeconds` | [Deadman](#deadman) | `int` | `300` | No |
| `Deadman.MissCount` | [Deadman](#deadman) | `int` | `3` | No |
| `Feedback.Enable` | [Feedback](#feedback) | `bool` | `false` | No |
| `Feedback.OverrideURL` | [Feedback](#feedback) | `string` | `""` | No |
| `General.ApplicationName` | [General](#general) | `string` | `"OnCallAlert"` | No |
| `General.DisableCalendarSubscriptions` | [General](#general) | `bool` | `false` | No |
| `General.DisableLabelCreation` | [General](#general) | `bool` | `false` | No |
| `General.DisableMessageBundles` | [General](#general) | `bool` | `false` | No |
| `General.DisableSMSLinks` | [General](#general) | `bool` | `false` | No |
| `General.GoogleAnalyticsID` | [General](#general) | `string` | `""` | No |
| `General.NotificationDisclaimer` | [General](#general) | `string` | `""` | No |
| `General.PublicURL` | [General](#general) | `string` | `""` | No |
| `General.ShortURL` | [General](#general) | `string` | `""` | No |
| `GitHub.AllowedOrgs` | [GitHub](#github) | `[]string` | `[]` | No |
| `GitHub.AllowedUsers` | [GitHub](#github) | `[]string` | `[]` | No |
| `GitHub.ClientID` | [GitHub](#github) | `string` | `""` | No |
| `GitHub.ClientSecret` | [GitHub](#github) | `string` | `"" (secret)` | Yes |
| `GitHub.Enable` | [GitHub](#github) | `bool` | `false` | No |
| `GitHub.EnterpriseURL` | [GitHub](#github) | `string` | `""` | No |
| `GitHub.NewUsers` | [GitHub](#github) | `bool` | `false` | No |
| `Mailgun.APIKey` | [Mailgun](#mailgun) | `string` | `"" (secret)` | Yes |
| `Mailgun.EmailDomain` | [Mailgun](#mailgun) | `string` | `""` | No |
| `Mailgun.Enable` | [Mailgun](#mailgun) | `bool` | `false` | No |
| `Maintenance.APIKeyExpireDays` | [Maintenance](#maintenance) | `int` | `0` | No |
| `Maintenance.AlertAutoCloseDays` | [Maintenance](#maintenance) | `int` | `0` | No |
| `Maintenance.AlertCleanupDays` | [Maintenance](#maintenance) | `int` | `0` | No |
| `Maintenance.AutoCloseAckedAlerts` | [Maintenance](#maintenance) | `bool` | `false` | No |
| `Maintenance.ScheduleCleanupDays` | [Maintenance](#maintenance) | `int` | `0` | No |
| `Mobile.Enable` | [Mobile](#mobile) | `bool` | `false` | No |
| `Mobile.RelayAPIKey` | [Mobile](#mobile) | `string` | `"" (secret)` | Yes |
| `Mobile.RelayURL` | [Mobile](#mobile) | `string` | `""` | No |
| `OIDC.ClientID` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.ClientSecret` | [OIDC](#oidc) | `string` | `"" (secret)` | Yes |
| `OIDC.Enable` | [OIDC](#oidc) | `bool` | `false` | No |
| `OIDC.IssuerURL` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.NewUsers` | [OIDC](#oidc) | `bool` | `false` | No |
| `OIDC.OverrideName` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.Scopes` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.UserInfoEmailPath` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.UserInfoEmailVerifiedPath` | [OIDC](#oidc) | `string` | `""` | No |
| `OIDC.UserInfoNamePath` | [OIDC](#oidc) | `string` | `""` | No |
| `SMTP.Address` | [SMTP](#smtp) | `string` | `""` | No |
| `SMTP.DisableTLS` | [SMTP](#smtp) | `bool` | `false` | No |
| `SMTP.Enable` | [SMTP](#smtp) | `bool` | `false` | No |
| `SMTP.From` | [SMTP](#smtp) | `string` | `""` | No |
| `SMTP.Password` | [SMTP](#smtp) | `string` | `"" (secret)` | Yes |
| `SMTP.SkipVerify` | [SMTP](#smtp) | `bool` | `false` | No |
| `SMTP.Username` | [SMTP](#smtp) | `string` | `""` | No |
| `Services.RequiredLabels` | [Services](#services) | `[]string` | `[]` | No |
| `Slack.AccessToken` | [Slack](#slack) | `string` | `"" (secret)` | Yes |
| `Slack.ClientID` | [Slack](#slack) | `string` | `""` | No |
| `Slack.ClientSecret` | [Slack](#slack) | `string` | `"" (secret)` | Yes |
| `Slack.DisableBroadcastThreadReplies` | [Slack](#slack) | `bool` | `false` | No |
| `Slack.Enable` | [Slack](#slack) | `bool` | `false` | No |
| `Slack.InteractiveMessages` | [Slack](#slack) | `bool` | `false` | No |
| `Slack.SigningSecret` | [Slack](#slack) | `string` | `"" (secret)` | Yes |
| `Twilio.AccountSID` | [Twilio](#twilio) | `string` | `""` | No |
| `Twilio.AlternateAuthToken` | [Twilio](#twilio) | `string` | `"" (secret)` | Yes |
| `Twilio.AuthToken` | [Twilio](#twilio) | `string` | `"" (secret)` | Yes |
| `Twilio.DisableCallProcessing` | [Twilio](#twilio) | `bool` | `false` | No |
| `Twilio.DisableSMSContactMethod` | [Twilio](#twilio) | `bool` | `false` | No |
| `Twilio.DisableTwoWaySMS` | [Twilio](#twilio) | `bool` | `false` | No |
| `Twilio.Enable` | [Twilio](#twilio) | `bool` | `false` | No |
| `Twilio.FromNumber` | [Twilio](#twilio) | `string` | `""` | No |
| `Twilio.MessagingServiceSID` | [Twilio](#twilio) | `string` | `""` | No |
| `Twilio.RCSSenderID` | [Twilio](#twilio) | `string` | `""` | No |
| `Twilio.SMSCarrierLookup` | [Twilio](#twilio) | `bool` | `false` | No |
| `Twilio.SMSFromNumberOverride` | [Twilio](#twilio) | `[]string` | `[]` | No |
| `Twilio.VoiceLanguage` | [Twilio](#twilio) | `string` | `""` | No |
| `Twilio.VoiceName` | [Twilio](#twilio) | `string` | `""` | No |
| `WebPush.Enable` | [WebPush](#webpush) | `bool` | `false` | No |
| `WebPush.SubscriberEmail` | [WebPush](#webpush) | `string` | `""` | No |
| `WebPush.VAPIDPrivateKey` | [WebPush](#webpush) | `string` | `"" (secret)` | Yes |
| `WebPush.VAPIDPublicKey` | [WebPush](#webpush) | `string` | `""` | No |
| `Webhook.AllowedURLs` | [Webhook](#webhook) | `[]string` | `[]` | No |
| `Webhook.Enable` | [Webhook](#webhook) | `bool` | `false` | No |
