Skip to main content
Lettr monitors your API usage and alerts you when failure rates spike. Alerts help you catch integration issues, misconfigured domains, or unexpected error patterns before they impact your users.

​
API Failure Rate Alerts

Lettr runs two automated checks against your API traffic:

​
15-Minute Rolling Window

Detects sudden spikes in error rates. If the failure rate in the last 15 minutes exceeds the threshold, an alert is triggered immediately. This catches acute issues like a broken integration deployment or an expired API key being used in production.

​
Daily Low-Volume Check

Detects sustained elevated error rates across lower-traffic periods. Even if individual 15-minute windows don’t breach the threshold, a consistently elevated daily failure rate triggers an alert. This catches chronic issues like a misconfigured domain or a gradual increase in invalid recipients.
Alert cooldowns are asymmetric — a 15-minute alert suppresses the daily alert for the same issue, but not vice versa. This prevents duplicate notifications while ensuring urgent issues are always surfaced.

​
Alert Channels

​
Email

Email alerts are enabled by default and sent to the team owner’s email address. Alert emails are sent through Lettr’s own transactional email system.

​
Webhook

Configure an HTTPS webhook URL to receive alerts as JSON POST requests. This is useful for integrating with incident management tools like PagerDuty, OpsGenie, or Slack.
Webhook URLs must be publicly accessible HTTPS endpoints. Private IP addresses and internal network URLs are blocked for security (SSRF protection).

​
Testing Your Webhook

After configuring a webhook URL, use the Test Webhook button to send a test payload and verify connectivity. The test confirms your endpoint is reachable and returns a success response.

​
Configuring Alerts

1

Navigate to Alert Settings

Go to Settings → Alerts.
2

Enable or Disable Alerts

Toggle alerts on or off for each alert type. You can enable the 15-minute check independently from the daily check.
3

Choose Alert Channels

Select which channels should receive alerts — email, webhook, or both.
4

Configure Webhook (Optional)

If using the webhook channel, enter your HTTPS endpoint URL and click Test Webhook to verify connectivity.
5

Save

Click Save to apply your alert configuration.

​
Best Practices

Even if your integration is stable, alerts provide early warning when something changes — a DNS misconfiguration, an expired certificate, or a code deployment that introduces errors.
Route webhook alerts to your incident management system (PagerDuty, OpsGenie, Slack) so the right person is notified immediately.
When you receive an alert, check the Analytics dashboard for error breakdowns to identify the root cause — whether it’s a specific domain, API key, or error type.

Analytics

Monitor sending metrics and error breakdowns

Errors & Retries

Understand API error codes and retry patterns