{ "name": "02 \u2013 Email Bounce & Complaint Auto-Handler", "nodes": [ { "id": "sticky-overview-02", "name": "Overview", "type": "n8n-nodes-base.stickyNote", "typeVersion": 1, "position": [ -240, -400 ], "parameters": { "content": "## \ud83d\udee1\ufe0f Bounce & Complaint Auto-Handler\n\n**What this workflow does:**\n1. Listens for `email.bounced` and `email.complained` events from Resend\n2. Routes each event type to its own handler\n3. Automatically marks the recipient as **unsubscribed** in Resend (protecting deliverability)\n4. Sends an internal alert email to your team\n\n**Why this matters:**\n- Hard bounces damage domain reputation if you keep sending\n- Spam complaints can get your account suspended\n- Automating list hygiene is a deliverability best practice\n\n> Inspired by Gmail-based bounce monitoring workflows, redesigned for Resend's native webhook events.", "height": 400, "width": 580, "color": 1 } }, { "id": "sticky-setup-02", "name": "Setup Instructions", "type": "n8n-nodes-base.stickyNote", "typeVersion": 1, "position": [ 330, -400 ], "parameters": { "content": "## \u2699\ufe0f Setup Required\n\n**Step 1 \u2013 Resend Webhook Signing Secret credential**\nCreate a \"Resend Webhook Signing Secret\" credential in n8n and add it to the Resend Trigger node.\n\n**Step 2 \u2013 Register the webhook in Resend**\nActivate this workflow, copy the **production webhook URL** shown in the Resend Trigger node, then paste it in your [Resend Webhooks dashboard](https://resend.com/webhooks).\nSelect events: `email.bounced` and `email.complained`.\n\n**Step 3 \u2013 Resend API credential**\nAdd your Resend API key to all four Resend action nodes.\n\n**Step 4 \u2013 Alert recipient**\nIn both \"Send Bounce Alert\" and \"Send Complaint Alert\" nodes, change `from` and `to` to your verified domain and team inbox.\n\n> \ud83d\udca1 Use **Test mode** in the Resend Trigger while building \u2014 click \"Listen for test event\" to see live events in the editor.", "height": 480, "width": 560, "color": 3 } }, { "id": "sticky-flow-02", "name": "Flow Note", "type": "n8n-nodes-base.stickyNote", "typeVersion": 1, "position": [ -240, 380 ], "parameters": { "content": "## \ud83d\udcdd Bounce vs. Complaint\n\n**Bounce (`email.bounced`)**\nThe email could not be delivered (e.g. invalid address, full mailbox). Update contact as unsubscribed to stop future sends.\n\n**Complaint (`email.complained`)**\nThe recipient marked the email as spam. This is more serious \u2014 treat it as high-priority and escalate if complaints exceed 0.1%.", "height": 240, "width": 540, "color": 7 } }, { "id": "n02-trigger", "name": "Resend Email Events", "type": "n8n-nodes-resend.resendTrigger", "typeVersion": 1, "position": [ -240, 100 ], "parameters": { "path": "resend-bounce-complaint", "events": [ "email.bounced", "email.complained" ] }, "credentials": { "resendWebhookSigningSecretApi": { "name": "" } } }, { "id": "n02-switch", "name": "Route by Event Type", "type": "n8n-nodes-base.switch", "typeVersion": 3, "position": [ 80, 100 ], "parameters": { "mode": "rules", "rules": { "values": [ { "conditions": { "options": { "caseSensitive": true, "leftValue": "", "typeValidation": "strict", "version": 2 }, "conditions": [ { "id": "bounce-check", "leftValue": "={{$json.type}}", "rightValue": "email.bounced", "operator": { "type": "string", "operation": "equals" } } ], "combinator": "and" }, "renameOutput": true, "outputKey": "Bounced" }, { "conditions": { "options": { "caseSensitive": true, "leftValue": "", "typeValidation": "strict", "version": 2 }, "conditions": [ { "id": "complaint-check", "leftValue": "={{$json.type}}", "rightValue": "email.complained", "operator": { "type": "string", "operation": "equals" } } ], "combinator": "and" }, "renameOutput": true, "outputKey": "Complained" } ] }, "options": { "fallbackOutput": "none" } } }, { "id": "n02-unsubscribe-bounce", "name": "Unsubscribe Contact (Bounce)", "type": "n8n-nodes-resend.resend", "typeVersion": 1, "position": [ 380, -60 ], "parameters": { "resource": "contacts", "operation": "update", "updateBy": "email", "contactEmail": "={{$json.data.to[0]}}", "contactUpdateFields": { "unsubscribed": true } }, "credentials": { "resendApi": { "name": "" } }, "continueOnFail": true }, { "id": "n02-unsubscribe-complaint", "name": "Unsubscribe Contact (Complaint)", "type": "n8n-nodes-resend.resend", "typeVersion": 1, "position": [ 380, 260 ], "parameters": { "resource": "contacts", "operation": "update", "updateBy": "email", "contactEmail": "={{$json.data.to[0]}}", "contactUpdateFields": { "unsubscribed": true } }, "credentials": { "resendApi": { "name": "" } }, "continueOnFail": true }, { "id": "n02-alert-bounce", "name": "Send Bounce Alert", "type": "n8n-nodes-resend.resend", "typeVersion": 1, "position": [ 700, -60 ], "parameters": { "resource": "email", "operation": "send", "from": "alerts@yourcompany.com", "to": "team@yourcompany.com", "subject": "=\u26a0\ufe0f Email Bounced: {{$node[\"Resend Email Events\"].json.data.to[0]}}", "useTemplate": false, "emailFormat": "html", "html": "=

\u26a0\ufe0f Email Bounce Detected

Bounced Address{{$node[\"Resend Email Events\"].json.data.to[0]}}
Email Subject{{$node[\"Resend Email Events\"].json.data.subject}}
Email ID{{$node[\"Resend Email Events\"].json.data.email_id}}
Event Time{{$node[\"Resend Email Events\"].json.data.created_at}}

\u2705 The contact has been automatically marked as unsubscribed in Resend.

", "additionalOptions": {} }, "credentials": { "resendApi": { "name": "" } } }, { "id": "n02-alert-complaint", "name": "Send Complaint Alert", "type": "n8n-nodes-resend.resend", "typeVersion": 1, "position": [ 700, 260 ], "parameters": { "resource": "email", "operation": "send", "from": "alerts@yourcompany.com", "to": "team@yourcompany.com", "subject": "=\ud83d\udea8 Spam Complaint Received: {{$node[\"Resend Email Events\"].json.data.to[0]}}", "useTemplate": false, "emailFormat": "html", "html": "=

\ud83d\udea8 Spam Complaint \u2013 Immediate Attention Required

A recipient has marked one of your emails as spam. This is a high-priority deliverability issue.

Complaint From{{$node[\"Resend Email Events\"].json.data.to[0]}}
Email Subject{{$node[\"Resend Email Events\"].json.data.subject}}
Email ID{{$node[\"Resend Email Events\"].json.data.email_id}}
Event Time{{$node[\"Resend Email Events\"].json.data.created_at}}
Action Required:
  • Review your recent campaigns for misleading subject lines or content
  • Check your audience segmentation and consent records
  • If complaint rate exceeds 0.1%, pause sending immediately

\u2705 The contact has been automatically unsubscribed in Resend.

", "additionalOptions": {} }, "credentials": { "resendApi": { "name": "" } } } ], "connections": { "Resend Email Events": { "main": [ [ { "node": "Route by Event Type", "type": "main", "index": 0 } ] ] }, "Route by Event Type": { "main": [ [ { "node": "Unsubscribe Contact (Bounce)", "type": "main", "index": 0 } ], [ { "node": "Unsubscribe Contact (Complaint)", "type": "main", "index": 0 } ] ] }, "Unsubscribe Contact (Bounce)": { "main": [ [ { "node": "Send Bounce Alert", "type": "main", "index": 0 } ] ] }, "Unsubscribe Contact (Complaint)": { "main": [ [ { "node": "Send Complaint Alert", "type": "main", "index": 0 } ] ] } }, "active": false, "settings": { "executionOrder": "v1" }, "versionId": "22222222-aaaa-bbbb-cccc-000000000002", "meta": { "templateCredsSetupCompleted": false }, "id": "resend-ex-02", "tags": [ { "id": "tag-resend-examples", "name": "resend-example" } ] }