Resources · n8n integration

Nextcloud n8n integrationAutomate Nextcloud with n8n.

Your Nextcloud can do more than store what people drop into it. The Nextcloud n8n integration exposes 17 operations over 3 resources, files, folders and users, so a workflow uploads, moves and shares on its own. There is no trigger node, so the start comes from elsewhere.

Verified Trustpilot reviews · AI, automation & growth agency

Why automate

What does the Nextcloud n8n integration actually do?

The Nextcloud node talks to your instance over WebDAV and the user provisioning API, and turns everyday file handling into workflow steps. It covers three resources: File, Folder and User. A workflow can create the folder of the month, drop a document into it, hand a link to a colleague, then read the folder back to check what landed there.

First scenario, the inbox that empties itself. A mail workflow picks up an invoice attachment, folder.create builds the destination path if it does not exist yet, and file.upload writes the document where accounting expects it. Teams running this on Gmail get a filing cabinet that fills without anyone dragging a file.

Second scenario, the quarterly archive. folder.list reads what a directory holds, a bit of logic sorts the old from the recent, and folder.move pushes last quarter under an archive tree. Write the resulting inventory into Google Sheets, or a Microsoft Excel 365 workbook if that is where the team already tracks things, and you have a paper trail of every move, dated, searchable, without touching the server.

Third scenario, onboarding. user.create invites the new hire, folder.create prepares their working directory, folder.share opens it to their group, and a message posted through Slack tells them where to look. The same chain runs in reverse on the last day, with user.delete at the end.

Nextcloud is often the destination rather than the source. Files arriving from Google Drive land here for long-term storage, which is the whole point of hosting your own instance. What the node passes between steps is a binary field, the slot inside an n8n item that carries the file itself rather than text, and both download and upload name that slot explicitly.

Two limits worth knowing before you build. There is no Nextcloud trigger node, so nothing starts from a Nextcloud event: a Schedule Trigger on a fixed interval, or an n8n Webhook called by another service, does the starting. And the node stops at files, folders and accounts. Talk, Calendar, Deck or anything else in your instance goes through the HTTP Request node, which calls any endpoint of the API while reusing the same credential. If you want a broader read on the platform before committing, the n8n review covers it.

Connect

How do you connect Nextcloud to n8n?

  1. 01

    Build your WebDAV URL

    Both authentication methods need a WebDAV URL. Take the address you use to reach Nextcloud and add /remote.php/webdav/ to it. An instance at https://cloud.n8n.com gives https://cloud.n8n.com/remote.php/webdav. If Nextcloud sits in a subdirectory, slot that subdirectory in first, before the remote.php part.

  2. 02

    Pick basic auth for the fast route

    Basic auth asks for the WebDAV URL, your User name and a Password. Nextcloud recommends an app password instead of your account password: open your avatar in the top right, go to Personal settings, then Security, scroll to the App Password section and generate one. Copy it into n8n. That credential is stored once and every Nextcloud node in every workflow reuses it from a dropdown.

  3. 03

    Or register an OAuth2 client

    In Nextcloud, open Administrator Security Settings, find Add client under OAuth 2.0 clients, name it something like n8n integration, paste the OAuth Callback URL that n8n shows as the Redirection URI, and select Add. Nextcloud returns a Client Identifier and a Secret, which become the Client ID and Client Secret in n8n.

Actions

What can the Nextcloud node do?

The Nextcloud node exposes 17 operations across 3 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.

Resources × operations matrix
ResourceCreateGetGet ManyUpdateDeleteCopyDownloadListMoveShareUpload
File✓✓✓✓✓✓
Folder✓✓✓✓✓✓
User✓✓✓✓✓

File

6 operations
01

Copy a file

file.copy

What you see in n8n

Notes & use cases

Duplicates a document and leaves the original untouched, so the copy can be edited, shared or archived on its own.

Key parameters

  • From Path: the path of the file to copy, starting with a slash, as in /invoices/original.txt. Coming from an earlier node, write it as an expression such as {{ $json.path }}, the n8n syntax for reading a field off the incoming item.
  • To Path: where the duplicate lands, also starting with a slash, for example /invoices/copy.txt.
Use cases
keeping a signed contract in its client folder while a second copy feeds the accounting tree.
02

Delete a file

file.delete

What you see in n8n

Notes & use cases

Erases the target from the instance. Nextcloud's own retention rules decide what happens next, and n8n returns no copy of what was removed.

Key parameters

  • Delete Path: the path to remove, starting with a slash, for instance /invoices/2019/invoice_1.pdf. The same field accepts a whole folder, which is why a typo here is expensive.
Use cases
clearing temporary exports once a nightly workflow has pushed them to their final destination, so the working directory never fills with yesterday's files.
03

Download a file

file.download

What you see in n8n

Notes & use cases

Pulls the file out of Nextcloud and into the workflow, where the next nodes can parse it, attach it to a message or forward it elsewhere.

Key parameters

  • File Path: the full path of the file to fetch, starting with a slash, such as /invoices/2019/invoice_1.pdf. Partial paths fail.
  • Put Output File in Field: the name of the output binary field that will hold the file. Downstream nodes expect that exact name, so keep it consistent across the workflow.
Use cases
fetching a supplier PDF before an extraction step reads the amounts out of it.
04

Move a file

file.move

What you see in n8n

Notes & use cases

Changes where a document lives. Nothing is duplicated: the file leaves the old path and only exists at the new one afterwards.

Key parameters

  • From Path: the current path of the file, as in /invoices/old_name.txt.
  • To Path: the new path. Change the last segment and you have renamed the file instead of relocating it, which is the trick behind most naming conventions.
Use cases
a document sitting in an inbox folder moves into the client directory as soon as a workflow has read which client it belongs to.
05

Share a file

file.share

What you see in n8n

Notes & use cases

Opens one document to someone outside the folder, either by link or by naming the recipient.

Key parameters

  • File Path: the full path of the file to share.
  • Share Type: who receives it, chosen among Public Link, User, Group, Email and Circle.
  • User, Group ID, Email or Circle ID: the recipient, matching the type selected above.
  • Options: Password protects the share, and Permissions sets what the recipient can do, from Read alone to All.
Use cases
sending a client a password-protected link to their invoice without creating an account for them.
06

Upload a file

file.upload

What you see in n8n

Notes & use cases

Writes a document into the instance. This is the operation most workflows end on, because Nextcloud is usually where things get stored rather than where they start.

Key parameters

  • File Path: the absolute destination path. The parent folder has to exist already, and an existing file at that path gets overwritten.
  • Binary File: on for a real file coming from a previous node, off to write text.
  • Input Binary Field: the name of the incoming binary field holding the file.
  • File Content: the text to write when Binary File stays off.
Use cases
filing every attachment received during the day.

Folder

6 operations
07

Copy a folder

folder.copy

What you see in n8n

Notes & use cases

Reproduces a directory and what it contains at a second location, original included. Useful when a structure has to exist twice rather than move.

Key parameters

  • From Path: the folder to copy, starting with a slash.
  • To Path: the destination path, which must not collide with an existing directory unless you intend to write into it.
Use cases
a project template directory, with its empty subfolders already named, gets copied for each new client so nobody has to rebuild the same tree by hand.
08

Create a folder

folder.create

What you see in n8n

Notes & use cases

Adds a directory at the path you give. Run it before any upload that targets a place which may not exist yet.

Key parameters

  • Folder: the path to create, starting with a slash, for example /invoices/2019. Only the last level is created: the parent has to be there already, so a deep tree needs one call per level.
Use cases
a monthly workflow opens the folder for the period, and every document produced that month is uploaded straight into it rather than piling up at the root.
09

Delete a folder

folder.delete

What you see in n8n

Notes & use cases

Removes a directory and everything under it in one call. There is no dry run and no per-file confirmation.

Key parameters

  • Delete Path: the path to remove, starting with a slash. Point it at a directory and the whole subtree goes, which is exactly what makes this operation worth guarding with an IF node before it.
Use cases
tearing down the scratch directory a batch job created for its run, once the results have been uploaded somewhere permanent.
10

List a folder

folder.list

What you see in n8n

Notes & use cases

Returns the contents of a directory, one item per entry, which the workflow can then filter, count or loop over.

Key parameters

  • Folder Path: the directory to read, starting with a slash, such as /invoices/2019/. Left empty, the node reads the root of the WebDAV URL set in the credential.
Use cases
checking every morning whether the drop folder still holds files nobody processed, and raising an alert when it does. It also gives the inventory before a bulk move or a cleanup run.
11

Move a folder

folder.move

What you see in n8n

Notes & use cases

Relocates a directory with its contents. The tree keeps its shape, only its parent changes.

Key parameters

  • From Path: the current folder path.
  • To Path: the new path. Moving a large tree in a single call can take a while, which is why some workflows prefer to list the folder and move its files one by one.
Use cases
pushing closed projects out of the active workspace and into an archive branch, so the shared directory only shows what teams are currently working on.
12

Share a folder

folder.share

What you see in n8n

Notes & use cases

Grants access to a whole directory, so anything added to it later is visible to the recipient without a second share.

Key parameters

  • File Path: the full path of the folder to share.
  • Share Type: Public Link, User, Group, Email or Circle.
  • User, Group ID, Email or Circle ID: whoever receives the access.
  • Options: Permissions decides between Read, Create, Update, Delete or All, and Password locks a public link.
Use cases
giving an external accountant Read access to the year's invoice folder and nothing else.

User

5 operations
13

Create a user

user.create

What you see in n8n

Notes & use cases

Invites someone to the Nextcloud organization. The account is created and the invitation goes to the address you provide.

Key parameters

  • Username: the identifier the person will log in with, like john. Every other user operation takes this same value, so decide the naming rule once.
  • Email: where the invitation lands.
  • Additional Fields: Display Name sets the readable name shown across the instance.
Use cases
an HR sheet gains a row, and the account exists before the first day.
14

Delete a user

user.delete

What you see in n8n

Notes & use cases

Closes an account on the instance. Run it at the end of an offboarding chain, after the files that account owned have been moved or copied somewhere shared.

Key parameters

  • Username: the identifier of the account to remove, not the display name and not the email address. Read it back with a get operation first if the workflow only knows the person by name.
Use cases
a departure recorded in the HR system triggers the cleanup the same evening, with no forgotten account left open for months.
15

Get a user

user.get

What you see in n8n

Notes & use cases

Reads back one account and returns its attributes, which the workflow can then test before doing anything else.

Key parameters

  • Username: the identifier to look up. Pass it from a previous node with {{ $json.userId }} when the value comes out of an earlier step.
Use cases
checking that an account exists before sharing a folder with it, since a share aimed at an unknown user fails and stops the run. It also serves as the lookup step in front of an update.
16

Get many users

user.getAll

What you see in n8n

Notes & use cases

Walks the account directory and returns the list, one item per user.

Key parameters

  • Return All: on, n8n follows the API pages until every account is returned; off, it stops at Limit.
  • Limit: the ceiling on how many accounts come back.
  • Options: Search narrows the list to matching accounts, and Offset skips the first ones, handy for processing a directory in slices.
Use cases
a monthly export of active accounts, compared against the HR list to spot who should no longer be there.
17

Update a user

user.update

What you see in n8n

Notes & use cases

Edits attributes on an account that already exists, without touching anything you leave alone.

Key parameters

  • Username: the account to edit, for instance john.
  • Update Fields: the attributes to change, added one at a time from the option list. An empty collection means the node runs and changes nothing, which is easy to miss when a workflow silently reports success.
Use cases
a role change in the HR tool updates the matching attributes on the Nextcloud account the same day.
Need help

Need help automating Nextcloud with n8n?

A person reads every message.

FAQ

Nextcloud and n8n, the questions that come up

01Is the Nextcloud n8n integration free?
Yes on the n8n side. The Nextcloud node ships with n8n, so there is nothing to install and nothing extra to pay for it, whether you run n8n Cloud, the hosted offer, or your own instance self-hosted with Docker or npm under the Community Edition and its Sustainable Use licence. A workflow behaves the same in both cases, which matters here because teams who self-host Nextcloud usually self-host n8n next to it. What your Nextcloud instance itself costs depends on how you run it, and that sits outside what the node does.
02What credentials do you need to connect Nextcloud to n8n?
Two methods work. Basic auth needs your WebDAV URL, your User name and a Password, and Nextcloud recommends generating an app password from Personal settings, then Security, then the App Password section rather than reusing your login password. OAuth2 needs an Authorization URL, an Access Token URL, a Client ID and a Client Secret, all produced when you add an OAuth 2.0 client in Administrator Security Settings, plus the same WebDAV URL. Either way the credential is created once in the Credentials menu and every Nextcloud node picks it from a dropdown afterwards.
03What are the limits of the Nextcloud node in n8n?
It covers three resources and nothing else: File, Folder and User, for 17 operations in total. Talk, Calendar, Deck, tags, comments and app management are not exposed. When you need one of those, the HTTP Request node calls any endpoint of the Nextcloud API and reuses the same credential through predefined authentication, so you stay on one connection. Inside the node, paths always start with a slash and have to be complete, an upload needs its parent folder to exist and overwrites whatever sits at the target path, and only the user list offers Return All to page through results.
04Can a workflow start from a Nextcloud event?
No. Nextcloud has no trigger node in n8n, so nothing in a workflow reacts to a file appearing in a folder on its own. Two patterns replace it. A Schedule Trigger runs at a fixed interval and calls the List a folder operation to see what changed since the last pass, which suits nightly filing and archive jobs. Or an n8n Webhook, a URL that another service calls, starts the workflow from outside, and Nextcloud then receives the result. Most real workflows here begin in another tool anyway, a mailbox or a form, and finish in Nextcloud.
05n8n or Make for Nextcloud?
It depends on where your files are allowed to live. Make is hosted, with no self-hosting option, and billed per operation, so a workflow that lists a folder and moves files one by one costs more as volume grows. n8n runs on your own server or on n8n Cloud, with the same workflow either way, which lines up with the reason most teams chose Nextcloud in the first place, keeping documents on infrastructure they control. Make is worth a look for its visual building and its hosted convenience. For a self-hosted document base driven at volume, n8n fits better.