mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node operation updates the mail settings for a specific project within the mittwald mStudio API. It allows users to modify either the blacklist or whitelist mail settings associated with a project by specifying the project ID and the desired mail setting type. This is useful in scenarios where administrators want to control which email addresses or domains are blocked (blacklist) or allowed (whitelist) for outgoing or incoming mail related to a project.

Practical examples include:

  • Adding or removing email addresses from a project's blacklist to prevent unwanted emails.
  • Managing a whitelist to ensure only approved senders can interact with the project's mailing system.

Properties

Name Meaning
Project Id The unique identifier of the project for which the mail setting will be updated.
Mail Setting The type of mail setting to update; options are "Blacklist" or "Whitelist".
Blacklist A JSON array representing the blacklist entries to apply. This field is used when updating the blacklist setting.

Output

The node outputs JSON data reflecting the result of the mail setting update operation. This typically includes confirmation of the updated settings or any relevant response data from the mittwald mStudio API. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for API requests.
  • The node depends on the @devlikeapro/n8n-openapi-node package and an OpenAPI specification (openapi.json) bundled internally for request building.

Troubleshooting

  • Invalid Project Id: If the provided project ID does not exist or is incorrect, the API may return an error indicating the project was not found. Verify the project ID before running the node.
  • Incorrect Mail Setting Type: Only "blacklist" or "whitelist" are valid options. Providing other values will cause the operation to fail.
  • Malformed JSON in Blacklist: The blacklist property expects a valid JSON array. Invalid JSON syntax will cause parsing errors. Ensure the JSON is well-formed.
  • Authentication Errors: Missing or invalid API credentials will result in authentication failures. Confirm that the API key credential is correctly configured.
  • API Rate Limits or Downtime: Temporary issues with the mittwald API could cause request failures. Check API status and retry later if needed.

Links and References

Discussion