Actions13
Alias → Create
AI-generatedOverview
This node operation creates a new email alias within a specified domain using the EmailConnect API. It allows users to define the local part of the email address, associate it with a webhook that receives emails sent to this alias, and configure additional optional settings such as whether the alias is active, if attachments are allowed, and what parts of the email (HTML, text, SMTP envelope) to include in the webhook payload. This is useful for automating email handling and routing in workflows, for example, creating support or info aliases that forward emails to specific webhooks for processing.
Use Case Examples
- Create an alias 'support' for the domain 'example.com' that routes incoming emails to a webhook handling support requests.
- Set up an alias with attachments allowed and include both HTML and plain-text email bodies in the webhook payload for detailed email processing.
Properties
| Name | Meaning |
|---|---|
| Domain Name or ID | The domain under which the alias will be created. Users can select from existing domains or specify an ID via expression. |
| Local Part | The local part of the email address before the '@' symbol, defining the alias name. |
| Webhook Name or ID | The webhook that will receive emails sent to this alias. Users can select from existing webhooks or specify an ID via expression. |
| Additional Fields | Optional settings for the alias such as whether it is active, allows attachments, and which parts of the email to include in the webhook payload. |
Output
JSON
localPart- The local part of the created alias email address.domainId- The domain ID under which the alias was created.webhookId- The webhook ID associated with the alias.active- Indicates if the alias is active.allowAttachments- Indicates if attachments are allowed in the webhook payload.includeEnvelope- Indicates if SMTP envelope data is included in the webhook payload.includeHtml- Indicates if the HTML body is included in the webhook payload.includeText- Indicates if the plain-text body is included in the webhook payload.
Dependencies
- EmailConnect API
- An API key credential for EmailConnect API authentication
Troubleshooting
- Ensure the domain ID and webhook ID are valid and exist in the EmailConnect account to avoid API errors.
- If no fields are provided for update operations, the node throws an error prompting to select at least one field.
- Check network connectivity and API key validity if requests to EmailConnect API fail.
Links
- n8n Expressions Documentation - Documentation on how to use expressions to specify dynamic values in node parameters.