n8n Variables

Flat variables workflows read through $vars at execution time.

Connection

What	This provider
Vendor	n8n
Key	`n8n-variables`
Availability	`available`. You can connect it today.
Credential we hold	`n8n-key`
Values read back	yes
Activation	`immediate`

Direction	What it does
`import`	We read names and values out of the store into your environment.
`export`	We write names and values from your environment into the store.

immediate. The running app sees a new value at once.

Direction	Policies you can pick
`import`	`skip_existing`, `new_version`, `fail`
`export`	`create_only`, `overwrite`, `overwrite_and_prune`

How syncs work says what each one does.

Paste a credential from the vendor. We seal it and never show it again.

Field	Label	Kind	Required	What it is
`apiKey`	API key	secret; we mask it here and seal it	yes	On a licensed plan, with variable:list, variable:create, variable:update and variable:delete.

You set these when you connect. Every mapping on the connection shares them.

Field	Label	Kind	Required	Advanced	What it is
`instanceUrl`	Instance URL	text	yes	no	Cloud or your own instance. Must be reachable from the internet.

You answer these once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`projectId`	Project	text	no	yes	Leave empty for the instance's own variables.

We probe for these when we verify the connection.

Permission	Directions	Blocking	Without it
`variable:list`	every direction	yes	Preview cannot list the instance's variables.
`variable:create`	`export`	yes	Export cannot write anything.
`variable:update`	`export`	yes	Export can add a variable but never change one that is already there.
`variable:delete`	`export`	yes	A prune cannot remove anything.