Community Package

Operations about community packages

List installed community packages

get

Retrieve all installed community packages with pending update info.

Authorizations

ApiKeyAuth

X-N8N-API-KEYstringRequired

Responses

200

Operation successful.

application/json

packageNamestringOptional

npm package name

installedVersionstringOptional

Currently installed version

authorNamestringOptional

Package author name

authorEmailstringOptional

Package author email

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

updateAvailablestringOptional

Version available for update, if any

failedLoadingbooleanOptional

Whether the package failed to load

401

Unauthorized

get/community-packages

HTTPcURLJavaScriptPython

GET /api/v1/community-packages HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

[
  {
    "packageName": "text",
    "installedVersion": "text",
    "authorName": "text",
    "authorEmail": "text",
    "installedNodes": [
      {
        "name": "text",
        "type": "text",
        "latestVersion": 1
      }
    ],
    "createdAt": "2026-07-19T15:29:38.380Z",
    "updatedAt": "2026-07-19T15:29:38.380Z",
    "updateAvailable": "text",
    "failedLoading": true
  }
]

Install a community package

post

Install a community package by npm name and optional version.

Authorizations

ApiKeyAuth

X-N8N-API-KEYstringRequired

Body

application/json

namestringRequired

npm package name (must start with n8n-nodes-)

versionstringOptional

Specific semver version to install

verifybooleanOptional

Whether to verify the package against the n8n-vetted package list. Required when the instance has N8N_UNVERIFIED_PACKAGES_ENABLED=false.

Responses

200

Package installed successfully.

application/json

packageNamestringOptional

npm package name

installedVersionstringOptional

Currently installed version

authorNamestringOptional

Package author name

authorEmailstringOptional

Package author email

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

updateAvailablestringOptional

Version available for update, if any

failedLoadingbooleanOptional

Whether the package failed to load

400

The request is invalid or provides malformed data.

401

Unauthorized

post/community-packages

HTTPcURLJavaScriptPython

POST /api/v1/community-packages HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "name": "text",
  "version": "text",
  "verify": true
}

{
  "packageName": "text",
  "installedVersion": "text",
  "authorName": "text",
  "authorEmail": "text",
  "installedNodes": [
    {
      "name": "text",
      "type": "text",
      "latestVersion": 1
    }
  ],
  "createdAt": "2026-07-19T15:29:38.380Z",
  "updatedAt": "2026-07-19T15:29:38.380Z",
  "updateAvailable": "text",
  "failedLoading": true
}

Uninstall a community package

delete

Uninstall a community package by name.

Authorizations

ApiKeyAuth

X-N8N-API-KEYstringRequired

Path parameters

namestringRequired

npm package name

Responses

204

Package uninstalled successfully.

No content

400

The request is invalid or provides malformed data.

401

Unauthorized

404

The specified resource was not found.

delete/community-packages/{name}

HTTPcURLJavaScriptPython

DELETE /api/v1/community-packages/{name} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Accept: */*

No content

Update a community package

patch

Update an installed community package to a new version.

Authorizations

ApiKeyAuth

X-N8N-API-KEYstringRequired

Path parameters

namestringRequired

npm package name

Body

application/json

versionstringOptional

Specific semver version to update to

verifybooleanOptional

Whether to verify the package against the n8n-vetted package list. Setting to false will allow installing or updating to an unverified version. Default is true.

Responses

200

Package updated successfully.

application/json

packageNamestringOptional

npm package name

installedVersionstringOptional

Currently installed version

authorNamestringOptional

Package author name

authorEmailstringOptional

Package author email

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

updateAvailablestringOptional

Version available for update, if any

failedLoadingbooleanOptional

Whether the package failed to load

400

The request is invalid or provides malformed data.

401

Unauthorized

404

The specified resource was not found.

patch/community-packages/{name}

HTTPcURLJavaScriptPython

PATCH /api/v1/community-packages/{name} HTTP/1.1
X-N8N-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "version": "text",
  "verify": true
}

{
  "packageName": "text",
  "installedVersion": "text",
  "authorName": "text",
  "authorEmail": "text",
  "installedNodes": [
    {
      "name": "text",
      "type": "text",
      "latestVersion": 1
    }
  ],
  "createdAt": "2026-07-19T15:29:38.380Z",
  "updatedAt": "2026-07-19T15:29:38.380Z",
  "updateAvailable": "text",
  "failedLoading": true
}