{
"meta": {
"instanceId": "04ab549d8bbb435ec33b81e4e29965c46cf6f0f9e7afe631018b5e34c8eead58"
},
"nodes": [
{
"id": "9fdbfdc1-67f3-4c8b-861c-9e5840b002ec",
"name": "Session",
"type": "n8n-nodes-base.httpRequest",
"position": [
780,
300
],
"parameters": {
"url": "https:\/\/api.fastmail.com\/jmap\/session",
"options": [],
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth"
},
"credentials": {
"httpHeaderAuth": {
"id": "BWkbkxgDD4hkRCvs",
"name": "Fastmail Masked E-Mail Addresses"
}
},
"typeVersion": 4.20000000000000017763568394002504646778106689453125
},
{
"id": "215d96fa-6bda-4e8c-884a-eb9a8db0838f",
"name": "create random masked email",
"type": "n8n-nodes-base.httpRequest",
"notes": "https:\/\/api.fastmail.com\/.well-known\/jmap\n\nhttps:\/\/api.fastmail.com\/jmap\/session",
"position": [
1280,
300
],
"parameters": {
"url": "https:\/\/api.fastmail.com\/jmap\/api\/",
"method": "POST",
"options": [],
"jsonBody": "={\n \"using\": [\n \"urn:ietf:params:jmap:core\",\n \"https:\/\/www.fastmail.com\/dev\/maskedemail\"\n ],\n \"methodCalls\": [\n [\n \"MaskedEmail\/set\",\n {\n \"accountId\": \"{{ $('Session').item.json.primaryAccounts['https:\/\/www.fastmail.com\/dev\/maskedemail'] }}\",\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": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"headerParameters": {
"parameters": [
{
"name": "Content-Type",
"value": "application\/json"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "BWkbkxgDD4hkRCvs",
"name": "Fastmail Masked E-Mail Addresses"
}
},
"typeVersion": 4.20000000000000017763568394002504646778106689453125
},
{
"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.100000000000000088817841970012523233890533447265625
},
{
"id": "6699eb83-a41e-44bc-b332-77e407fb3542",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"position": [
460,
480
],
"parameters": {
"width": 1654.820332457153199356980621814727783203125,
"height": 471.7543047051136682057403959333896636962890625,
"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' https:\/\/your-n8n-instance\/webhook\/87f9abd1-2c9b-4d1f-8c7f-2261f4698c3c -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
},
{
"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.399999999999999911182158029987476766109466552734375
},
{
"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.399999999999999911182158029987476766109466552734375
},
{
"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
}
],
"pinData": [],
"connections": {
"Session": {
"main": [
[
{
"node": "get fields for creation",
"type": "main",
"index": 0
}
]
]
},
"Webhook": {
"main": [
[
{
"node": "Session",
"type": "main",
"index": 0
}
]
]
},
"prepare output": {
"main": [
[
{
"node": "Respond to Webhook",
"type": "main",
"index": 0
}
]
]
},
"get fields for creation": {
"main": [
[
{
"node": "create random masked email",
"type": "main",
"index": 0
}
]
]
},
"create random masked email": {
"main": [
[
{
"node": "prepare output",
"type": "main",
"index": 0
}
]
]
}
}
}
