id: resend-domain-dns-and-bounce-rate-sentinel
namespace: company.messaging
description: |
Audit Resend email sending domains and DNS verification status on a recurring schedule,
detecting broken DKIM, SPF, or MX records before email deliverability and sender reputation drop.
inputs:
- id: target_domain
type: STRING
defaults: "example.com"
displayName: "Sending Domain"
description: "Primary sending domain name registered on Resend (e.g.
mail.yourcompany.com or example.com)."
- id: notification_channel
type: STRING
defaults: "#messaging-ops"
displayName: "Slack Notification Channel"
description: "Destination Slack channel receiving DNS drift alerts and domain
status warnings."
- id: remediation_mode
type: SELECT
values:
- "ALERT_ONLY"
- "LOG_DNS_RECORDS"
defaults: "ALERT_ONLY"
displayName: "Remediation Strategy"
description: "Response strategy on degraded domain: dispatch a Slack
notification only or log expected DNS records."
triggers:
- id: periodic_resend_audit
type: io.kestra.plugin.core.trigger.Schedule
cron: "0 8 * * *"
disabled: true
inputs:
target_domain: "example.com"
notification_channel: "#messaging-ops"
remediation_mode: "ALERT_ONLY"
tasks:
- id: fetch_resend_domains
type: io.kestra.plugin.core.http.Request
description: "Query Resend Domains API to retrieve verification status and DNS records."
uri: "https://api.resend.com/domains"
method: GET
headers:
Authorization: "Bearer {{ secret('RESEND_API_KEY') }}"
Content-Type: "application/json"
contentType: "application/json"
- id: parse_domain_reputation
type: io.kestra.plugin.scripts.python.Script
description: "Inspect domain verification status, check DKIM and SPF records,
and isolate unverified domains."
containerImage: python:3.11-slim
env:
RAW_DOMAINS: "{{ outputs.fetch_resend_domains.body }}"
TARGET_DOMAIN: "{{ inputs.target_domain }}"
script: |
import os
import json
raw_payload = os.environ.get("RAW_DOMAINS", "{}")
target_domain = os.environ.get("TARGET_DOMAIN", "").lower().strip()
try:
data = json.loads(raw_payload) if isinstance(raw_payload, str) and raw_payload.startswith("{") else {}
except Exception:
data = {}
domain_list = data.get("data", [])
degraded_domains = []
matched = False
for dom in domain_list:
name = dom.get("name", "").lower()
if target_domain and target_domain not in name:
continue
matched = True
status = dom.get("status", "not_started").lower()
records = dom.get("records", [])
failing_records = [r.get("record", "unknown") for r in records if r.get("status", "").lower() != "verified"]
if status != "verified" or len(failing_records) > 0:
degraded_domains.append({
"id": dom.get("id"),
"name": dom.get("name"),
"status": status,
"region": dom.get("region", "us-east-1"),
"failing_records": failing_records
})
classification = "DOMAIN_DEGRADED" if len(degraded_domains) > 0 else "HEALTHY"
outputs = {
"status": classification,
"target_domain_matched": matched,
"total_domains_checked": len(domain_list),
"degraded_count": len(degraded_domains),
"degraded_domains": degraded_domains
}
print(f"Resend Audit: {len(degraded_domains)} degraded domains found - Status: {classification}")
print("::" + json.dumps({"outputs": outputs}) + "::")
- id: evaluate_domain_health
type: io.kestra.plugin.core.flow.Switch
description: "Route workflow execution based on whether sending domains have
unverified DNS records."
value: "{{ outputs.parse_domain_reputation.vars.status }}"
cases:
"HEALTHY":
- id: log_domain_healthy
type: io.kestra.plugin.core.log.Log
description: "Record healthy status when sending domains report verified DKIM,
SPF, and MX status."
message: "Resend domain status is healthy for '{{ inputs.target_domain }}'. All
DNS records verified."
"DOMAIN_DEGRADED":
- id: alert_domain_degradation
type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
description: "Dispatch urgent operational notification to Slack detailing Resend
DNS verification failure."
url: "{{ secret('SLACK_WEBHOOK') }}"
payload: |
{
"channel": "{{ inputs.notification_channel }}",
"blocks": [
{
"type": "header",
"text": {
"type": "plain_text",
"text": "🚨 Resend Domain DNS Verification Alert"
}
},
{
"type": "section",
"fields": [
{
"type": "mrkdwn",
"text": "*Sending Domain:*\n`{{ inputs.target_domain }}`"
},
{
"type": "mrkdwn",
"text": "*Verification State:*\n🔥 *{{ outputs.parse_domain_reputation.vars.degraded_domains[0]['status'] }}*"
},
{
"type": "mrkdwn",
"text": "*Domain ID:*\n`{{ outputs.parse_domain_reputation.vars.degraded_domains[0]['id'] }}`"
},
{
"type": "mrkdwn",
"text": "*Region:*\n`{{ outputs.parse_domain_reputation.vars.degraded_domains[0]['region'] }}`"
}
]
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "⚠️ *Action Required:* Domain `{{ outputs.parse_domain_reputation.vars.degraded_domains[0]['name'] }}` has unverified or failing DNS records. Review DKIM and SPF entries in Cloudflare or Route 53 to prevent email delivery failure."
}
}
]
}
- id: log_remediation_guidance
type: io.kestra.plugin.core.log.Log
description: "Log diagnostic guidance for infrastructure teams to resolve broken
Resend DNS records."
message: "Resend Remediation: Sending domain '{{
outputs.parse_domain_reputation.vars.degraded_domains[0]['name'] }}'
is in state '{{
outputs.parse_domain_reputation.vars.degraded_domains[0]['status']
}}'. Verify TXT and CNAME DKIM keys on resend.com/domains. Mode: {{
inputs.remediation_mode }}."
defaults:
- id: log_unknown_state
type: io.kestra.plugin.core.log.Log
description: "Fallback logger for unclassified domain audit states."
message: "Resend domain audit completed with unclassified metrics."
- id: log_audit_completion
type: io.kestra.plugin.core.log.Log
description: "Record completion of the Resend domain sentinel inspection run."
message: "Resend domain sentinel audit pass completed for '{{
inputs.target_domain }}'. Degraded count: {{
outputs.parse_domain_reputation.vars.degraded_count ?? 0 }}."
errors:
- id: alert_on_failure
type: io.kestra.plugin.slack.notifications.SlackIncomingWebhook
description: "Dispatch urgent Slack notification if flow execution encounters an
unhandled exception."
url: "{{ secret('SLACK_WEBHOOK') }}"
payload: |
{"text": "Flow execution failed: resend-domain-dns-and-bounce-rate-sentinel encountered an unhandled error during execution {{ execution.id }}."}