n8n-code-python

To run Python in n8n Code nodes, use only the standard library for data transformation and parsing. Access batch or per-item data via _input.all() or _input.item, then return results as a list of items wrapped in {"json": ...} dictionaries.

Accessing webhook payload data directly causes a KeyError because the data is nested under the body key in _json. Use safe dictionary access with .get() to retrieve values from the body key and prevent runtime errors in your n8n Code node.

The Python Code node in n8n must return an array of objects, with each object containing a json field. Wrap your transformed data as {"json": ...} inside a list to ensure n8n processes the output correctly across subsequent workflow nodes.

You cannot use external Python dependencies in n8n Code nodes. The environment is restricted to the standard library, including modules like json, datetime, re, base64, hashlib, and urllib.parse, ensuring safe execution without network calls or heavy libraries.

The best way to handle per-item data transformation in n8n Python scripts is using _input.item for individual items or _input.all() for batch processing. Apply standard library functions for parsing and return the results as a list of json-wrapped dictionaries.