mittwald icon

mittwald

Interact with mittwald mStudio API

Actions100

Overview

This node operation allows you to create a project invitation within a specified project. It is useful when you want to invite a new member to collaborate on a project by sending them an invite via email. The invite can specify the role of the invitee, an optional message, and an expiration time for their membership.

Practical examples include:

  • Inviting a new team member to join a project with a specific role such as Owner or External collaborator.
  • Sending a personalized message along with the invitation.
  • Setting a time limit on how long the invited member’s access will last.

Properties

Name Meaning
Project Id The unique identifier of the project where the invite will be created.
Mail Address The email address of the person to be invited to the project.
Membership Expires At Optional expiration date/time for the membership granted by the invite.
Message Optional custom message included in the invitation email.
Role The role assigned to the invited user. Options: Notset, Owner, Emailadmin, External.

Output

The node outputs JSON data representing the created project invitation. This typically includes details such as the invite ID, status, associated project ID, invited email, role, expiration time, and any message sent. The output does not include binary data.

Dependencies

  • Requires an API key credential to authenticate requests against the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de for API calls.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Project Id may cause the API to reject the request.
    • Incorrect or malformed email addresses can result in failed invitations.
    • Expiration dates must be valid ISO date strings; invalid formats may cause errors.
    • Insufficient permissions for the API key may prevent creating invites.
  • Error messages:

    • "Unauthorized" — Check that the API key credential is correctly configured and has required permissions.
    • "Project not found" — Verify the Project Id is correct and exists.
    • "Invalid email address" — Ensure the mail address is properly formatted.
    • "Role not allowed" — Confirm the selected role is one of the supported options.

Resolving these usually involves verifying input values and ensuring the API credentials have appropriate access rights.

Links and References

Discussion