{ "meta": { "instanceId": "workflow-e822a471", "versionId": "1.0.0", "createdAt": "2025-09-29T07:07:45.990119", "updatedAt": "2025-09-29T07:07:45.990141", "owner": "n8n-user", "license": "MIT", "category": "automation", "status": "active", "priority": "high", "environment": "production" }, "nodes": [ { "id": "9fdbfdc1-67f3-4c8b-861c-9e5840b002ec", "name": "Session", "type": "n8n-nodes-base.httpRequest", "position": [ 780, 300 ], "parameters": { "url": "{{ $env.API_BASE_URL }}", "options": {}, "authentication": "{{ $credentials.genericCredentialType }}", "genericAuthType": "httpHeaderAuth" }, "credentials": { "httpHeaderAuth": { "id": "BWkbkxgDD4hkRCvs", "name": "Fastmail Masked E-Mail Addresses" } }, "typeVersion": 4.2, "notes": "This httpRequest node performs automated tasks as part of the workflow." }, { "id": "215d96fa-6bda-4e8c-884a-eb9a8db0838f", "name": "create random masked email", "type": "n8n-nodes-base.httpRequest", "notes": "{{ $env.API_BASE_URL }}\n\n{{ $env.API_BASE_URL }}", "position": [ 1280, 300 ], "parameters": { "url": "{{ $env.API_BASE_URL }}", "method": "POST", "options": {}, "jsonBody": "={\n \"using\": [\n \"urn:ietf:params:jmap:core\",\n \"{{ $env.WEBHOOK_URL }}\"\n ],\n \"methodCalls\": [\n [\n \"MaskedEmail/set\",\n {\n \"accountId\": \"{{ $('Session').item.json.primaryAccounts['{{ $env.WEBHOOK_URL }}'] }}\",\n \"create\": {\n \"maskedEmailId1\": {\n \"description\": \"{{ $json.description }}\",\n \"state\": \"{{ $json.state }}\"\n }\n }\n },\n \"c1\"\n ]\n ]\n}\n", "sendBody": true, "sendHeaders": true, "specifyBody": "json", "authentication": "{{ $credentials.genericCredentialType }}", "genericAuthType": "httpHeaderAuth", "headerParameters": { "parameters": [ { "name": "Content-Type", "value": "application/json" } ] } }, "credentials": { "httpHeaderAuth": { "id": "BWkbkxgDD4hkRCvs", "name": "Fastmail Masked E-Mail Addresses" } }, "typeVersion": 4.2 }, { "id": "237f6596-f8df-4c21-a2fa-44e935a72d56", "name": "Respond to Webhook", "type": "n8n-nodes-base.respondToWebhook", "position": [ 1800, 300 ], "parameters": { "options": {}, "respondWith": "text", "responseBody": "={{ $json }}" }, "typeVersion": 1.1, "notes": "This respondToWebhook node performs automated tasks as part of the workflow." }, { "id": "6699eb83-a41e-44bc-b332-77e407fb3542", "name": "Sticky Note", "type": "n8n-nodes-base.stickyNote", "position": [ 460, 480 ], "parameters": { "width": 1654.8203324571532, "height": 471.75430470511367, "content": "### Template Description\nThis n8n workflow template allows you to create a masked email address using the Fastmail API, triggered by a webhook. This is especially useful for generating disposable email addresses for privacy-conscious users or for testing purposes.\n\n#### Workflow Details:\n1. **Webhook Trigger**: The workflow is initiated by sending a POST request to a specific webhook. You can include `state` and `description` in your request body to customize the masked email's state and description.\n2. **Session Retrieval**: The workflow makes an HTTP request to the Fastmail API to retrieve session information. It uses this data to authenticate further requests.\n3. **Create Masked Email**: Using the retrieved session data, the workflow sends a POST request to Fastmail's JMAP API to create a masked email. It uses the provided state and description from the webhook payload.\n4. **Prepare Output**: Once the masked email is successfully created, the workflow extracts the email address and attaches the description for further processing.\n5. **Respond to Webhook**: Finally, the workflow responds to the original POST request with the newly created masked email and its description.\n\n#### Requirements:\n- **Fastmail API Access**: You will need valid API credentials for Fastmail configured with HTTP Header Authentication.\n- **Authorization Setup**: Optionally set up authorization if your webhook is exposed to the internet to prevent misuse.\n- **Custom Webhook Request**: Use a tool like `curl` or create a shortcut on macOS/iOS to send the POST request to the webhook with the necessary JSON payload, like so:\n \n ```bash\n curl -X POST -H 'Content-Type: application/json' {{ $env.WEBHOOK_URL }} -d '{\"state\": \"pending\", \"description\": \"my mega fancy masked email\"}'\n ```\n\nThis template simplifies the process of integrating masked email functionality into your projects or workflows and can be extended for various use cases." }, "typeVersion": 1, "notes": "This stickyNote node performs automated tasks as part of the workflow." }, { "id": "0c5d6d5a-ad0f-451e-9075-1009c8bf7212", "name": "get fields for creation", "type": "n8n-nodes-base.set", "position": [ 1000, 300 ], "parameters": { "options": {}, "assignments": { "assignments": [ { "id": "870bb03d-c672-49d6-9652-5a0233b16eb2", "name": "state", "type": "string", "value": "={{ $('Webhook').item.json.body.state ?? \"pending\" }}" }, { "id": "ac9b45a0-885f-48b2-b0ec-e38c79080045", "name": "description", "type": "string", "value": "={{ $('Webhook').item.json.body.description ?? \"Test via N8n\" }}" } ] } }, "typeVersion": 3.4, "notes": "This set node performs automated tasks as part of the workflow." }, { "id": "be7ba978-00d7-4fb1-9e1b-e3f83285e6fb", "name": "prepare output", "type": "n8n-nodes-base.set", "position": [ 1540, 300 ], "parameters": { "options": {}, "assignments": { "assignments": [ { "id": "19a09822-7ae0-4884-9192-c6e5bc3393a8", "name": "email", "type": "string", "value": "={{ $json.methodResponses[0][1].created.maskedEmailId1.email }}" }, { "id": "ae8a1fe4-3010-4db8-aa88-f6074cae3006", "name": "desciption", "type": "string", "value": "={{ $('get fields for creation').item.json.description }}" } ] } }, "typeVersion": 3.4, "notes": "This set node performs automated tasks as part of the workflow." }, { "id": "dd014889-81eb-4a94-886e-4fe084c504ff", "name": "Webhook", "type": "n8n-nodes-base.webhook", "position": [ 540, 300 ], "webhookId": "87f9abd1-2c9b-4d1f-8c7f-2261f4698c3c", "parameters": { "path": "createMaskedEmail", "options": {}, "httpMethod": "POST", "responseMode": "responseNode" }, "typeVersion": 2, "notes": "This webhook node performs automated tasks as part of the workflow." } ], "pinData": {}, "connections": { "9fdbfdc1-67f3-4c8b-861c-9e5840b002ec": { "main": [ [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-861c066d", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-2edae31e", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-13a2459b", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-e75c422a", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-a9ab332f", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-6bbe96d2", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-53d489ea", "type": "main", "index": 0 } ], [ { "node": "error-handler-9fdbfdc1-67f3-4c8b-861c-9e5840b002ec-bdc45cf3", "type": "main", "index": 0 } ] ] }, "215d96fa-6bda-4e8c-884a-eb9a8db0838f": { "main": [ [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-27647592", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-9934a0cd", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-85b8e6e3", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-e94a1b47", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-5c55b6ce", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-57713b27", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-c319b89c", "type": "main", "index": 0 } ], [ { "node": "error-handler-215d96fa-6bda-4e8c-884a-eb9a8db0838f-2763daa5", "type": "main", "index": 0 } ] ] }, "237f6596-f8df-4c21-a2fa-44e935a72d56": { "main": [ [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-a45a0f8d", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-5bfe0c38", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-f6937907", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-c03c14dd", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-1fac1954", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-68eeb62b", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-fb0083b3", "type": "main", "index": 0 } ], [ { "node": "error-handler-237f6596-f8df-4c21-a2fa-44e935a72d56-90757047", "type": "main", "index": 0 } ] ] }, "dd014889-81eb-4a94-886e-4fe084c504ff": { "main": [ [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-73eb59d3", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-b0f73801", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-6ece71a3", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-3e0dbe04", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-42c03d19", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-9fe067fb", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-3c0d99eb", "type": "main", "index": 0 } ], [ { "node": "error-handler-dd014889-81eb-4a94-886e-4fe084c504ff-10ad3c2b", "type": "main", "index": 0 } ] ] } }, "name": "Httprequest Workflow", "settings": { "executionOrder": "v1", "saveManualExecutions": true, "callerPolicy": "workflowsFromSameOwner", "errorWorkflow": null, "timezone": "UTC", "executionTimeout": 3600, "maxExecutions": 1000, "retryOnFail": true, "retryCount": 3, "retryDelay": 1000 }, "description": "Automated workflow: Httprequest Workflow. This workflow integrates 6 different services: webhook, stickyNote, httpRequest, set, respondToWebhook. It contains 15 nodes and follows best practices for error handling and security.", "tags": [ "automation", "n8n", "production-ready", "excellent", "optimized" ], "notes": "Excellent quality workflow: Httprequest Workflow. This workflow has been optimized for production use with comprehensive error handling, security, and documentation." }