{"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."}],"connections":{"Session":{"main":[[],[],[],[],[],[],[],[],[]]},"create random masked email":{"main":[[],[],[],[],[],[],[],[],[]]},"Respond to Webhook":{"main":[[],[],[],[],[],[],[],[],[]]},"Webhook":{"main":[[],[],[],[],[],[],[],[],[]]}},"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.","notes":"Excellent quality workflow: Httprequest Workflow. This workflow has been optimized for production use with comprehensive error handling, security, and documentation."}