Joplin icon

Joplin

Consume Joplin API

Actions9

Folder → Create

AI-generated

Overview

This node allows you to create a new folder in Joplin via its API. It is useful for automating the organization of notes and folders within your Joplin workspace from n8n workflows. Common scenarios include:

  • Automatically creating project or topic folders when new tasks or clients are added.
  • Structuring note storage dynamically based on workflow triggers.
  • Integrating Joplin with other tools that require folder creation as part of a process.

Example:
When a new client is onboarded in your CRM, this node can automatically create a corresponding folder in Joplin to store all related notes and documentation.

Properties

Name Type Meaning
Name String The title of the new folder to be created. This is required.
Additional Fields Collection Optional fields to further specify folder properties.
└─ New Folder Parent Name or ID Options The ID of the parent folder under which the new folder will be created. You can select from existing folders or provide an ID via expression.
└─ Time Fixed Collection Allows setting custom creation and update times for the folder.
└─ User_created_time Number Epoch timestamp indicating when the folder was created (can be set manually).
└─ User_updated_time Number Epoch timestamp indicating when the folder was last updated (can be set manually).

Output

The node outputs a JSON object containing the response from the Joplin API after creating the folder. The structure is:

{
  "res": {
    // Joplin API response for the created folder, typically includes:
    "id": "string",
    "parent_id": "string",
    "title": "string",
    "created_time": number,
    "updated_time": number,
    // ...other Joplin folder properties
  }
}
  • The exact fields inside res depend on the Joplin API but generally include the folder's ID, title, parent ID, and timestamps.

Dependencies

  • Joplin API: Requires access to a running Joplin server with the API enabled.
  • API Credentials: You must configure the jApi credential in n8n, providing the Joplin API base URL and token.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the API base URL or token is incorrect, the node will fail to connect to Joplin.
  • Missing Required Field: If the "Name" property is not provided, the node will throw an error.
  • Parent Folder Not Found: If an invalid parent folder ID is specified, the API may return an error.

Error Messages & Resolutions:

  • "Request failed with status code 401": Check your Joplin API token and base URL in the credentials.
  • "Missing required parameter: title": Ensure the "Name" field is filled in.
  • "Parent folder not found": Verify the parent folder ID exists in Joplin.

Links and References

Discussion