NAppwrite icon

NAppwrite

Use Appwrite's API from inside N8N, updated by @ZachHandley

Overview

This node allows you to interact with Appwrite's cloud functions within an n8n workflow. Specifically, the "Execute Function" operation lets you run a serverless function hosted on Appwrite by specifying its unique Function ID and passing input data to it. This is useful for extending your workflows with custom backend logic, such as processing data, integrating with other services, or performing complex computations that are not directly supported by n8n.

Practical examples:

  • Triggering a custom image processing function that resizes or filters images.
  • Executing a business logic function that calculates discounts or pricing based on input parameters.
  • Running a data transformation function that formats or enriches incoming data before further processing.

Properties

Name Meaning
Function ID The unique identifier of the Appwrite function you want to execute.
Data JSON-formatted input data to send to the function when executing it.

Output

The node outputs the JSON response returned by the executed Appwrite function in the json output field. This typically contains the result or output data generated by the function after execution.

If the function returns binary data, it would be included in the output accordingly, but this node primarily handles JSON responses.

Dependencies

  • Requires an active Appwrite project with configured cloud functions.
  • Needs an API key credential for authenticating requests to the Appwrite API.
  • The node depends on the node-appwrite SDK and internal helper methods to communicate with Appwrite services.
  • Proper configuration of the Appwrite endpoint URL, project ID, and API key must be provided in the node credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Function ID will cause the execution to fail.
    • Malformed JSON in the "Data" property can lead to errors when sending input to the function.
    • Network or authentication errors if the API key or project details are incorrect.
    • The function itself may throw errors if the input data does not meet expected formats or constraints.
  • Error messages:

    • Errors from Appwrite API calls will be surfaced, often indicating issues like "Function not found," "Unauthorized," or "Invalid input."
    • To resolve, verify the Function ID, ensure the API key has sufficient permissions, and validate the input data format.

Links and References

Discussion