mittwald icon

mittwald

Interact with mittwald mStudio API

Actions409

Overview

This node interacts with the mittwald mStudio API to list customers. It allows users to retrieve a filtered and paginated list of customers based on specific criteria such as user roles, search terms, and pagination controls. This is useful in scenarios where you need to integrate customer data from mittwald into workflows for reporting, synchronization, or further processing.

Practical examples:

  • Fetching all customers where the authenticated user has a particular role.
  • Searching customers by name, number, or ID using simple regular expressions.
  • Paginating through large customer lists by specifying limits and offsets.

Properties

Name Meaning
Role Filter to list only customers where the authenticated user has the specified role. Can be a comma-separated list of roles.
Search Text search for customer number, customer name, and ID. Supports simple regular expressions.
Limit The maximum number of customer records to return in the response. Defaults to 1000.
Skip Number of items to skip before starting to collect the result set. Should be a multiple of limit.
Page Page number to display. If both page and skip are set, skip takes precedence.

Output

The node outputs a JSON array containing customer objects retrieved from the mittwald API. Each object represents a customer with fields as defined by the API schema (not detailed here). The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the mittwald mStudio API.
  • The node uses the base URL https://api.mittwald.de.
  • The node depends on the @devlikeapro/n8n-openapi-node package for OpenAPI integration.

Troubleshooting

  • Empty results: Ensure that the filters (role, search) are correctly specified and match existing customers.
  • Pagination issues: When using skip and page together, skip overrides page. Make sure to use them consistently.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
  • Rate limiting or API errors: Check the API response messages for rate limit warnings or other errors and adjust request frequency accordingly.

Links and References

Discussion