mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node facilitates creating a relocation request for a web hosting or online shop service with the mittwald mStudio API. It is designed to automate and manage the transfer of websites, domains, email inboxes, and related services from an existing provider to mittwald. Typical use cases include migrating CMS hosting, online shops, or express versions of these services to mittwald's infrastructure.

Practical examples:

  • Migrating a CMS-hosted website including all associated domains and email inboxes.
  • Transferring an online shop setup with specific additional services and pricing details.
  • Handling partial domain transfers by specifying which domains to move when not transferring all.

Properties

Name Meaning
Additional Services JSON object detailing extra services requested during relocation.
All Domains Boolean indicating whether all project-related domains should be transferred to mittwald.
Allow Password Change Boolean (must be true) confirming consent for mittwald team to change and access passwords at current provider.
Article Type Type of article to relocate; options: Cms Hosting, Cms Hosting Express, Onlineshop, Onlineshop Express.
Contact JSON object containing contact information relevant to the relocation process.
Domains JSON array listing specific domains to transfer if "All Domains" is false.
Email Inboxes JSON array listing email inboxes to be transferred.
Notes String for any additional instructions or information for customer service regarding the relocation.
Prices JSON object describing pricing positions related to the relocation.
Provider JSON object with details about the current provider from which services are being relocated.
Target JSON object specifying the target configuration or destination details for the relocation.
User Id Optional string identifier for the user initiating the relocation.

Output

The node outputs JSON data representing the response from the mittwald mStudio API after creating the relocation request. This typically includes confirmation details, status, and any identifiers related to the newly created relocation order.

No binary data output is indicated.

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.
  • Proper configuration of the API authentication in n8n credentials is necessary.

Troubleshooting

  • Common Issues:

    • Missing required fields such as allowPasswordChange (which must be true), articleType, or provider details can cause request failures.
    • Incorrect JSON formatting in properties like additionalServices, contact, domains, emailInboxes, or prices may lead to parsing errors.
    • If the API key credential is invalid or missing, authentication errors will occur.
  • Error Messages:

    • Authentication errors usually indicate issues with the API key or credential setup.
    • Validation errors from the API may specify missing or invalid fields; ensure all required properties are correctly filled.
    • JSON parse errors suggest malformed JSON input in the respective properties.
  • Resolution Tips:

    • Always set allowPasswordChange to true as required.
    • Validate JSON inputs before running the node.
    • Confirm that the API key credential is correctly configured and active.
    • Review API response messages for specific field errors and adjust inputs accordingly.

Links and References

Discussion