FAQ

Installation

Can't find the TTLock node in n8n after installing?

You must restart n8n after installing community nodes for changes to take effect. If it still doesn't appear after restart:

1. Confirm the installed package name is n8n-nodes-ttlock
2. Check that n8n version >= 1.0.0 (visible in n8n Settings page)
3. Check n8n startup logs for loading errors

Failed to install community node from n8n UI?

Try installing via command line:

npm install n8n-nodes-ttlock

Restart n8n after installation.

Credentials

Authentication failed or token retrieval failed?

1. Confirm Client ID and Client Secret are correct with no extra spaces
2. Confirm the username and password are your TTLock platform login credentials, not developer account credentials

Time

What format should time parameters use?

Millisecond timestamps (13 digits) are recommended, especially when using n8n expressions. The plugin also supports second-level timestamps (10 digits) and date strings (e.g., 2026-05-07 09:00:00).

Be aware of timezone differences between your n8n server and lock location.

Example Workflows

TTLock node shows red triangle after import, error says credential needed?

After importing a workflow, the TTLock node may show a red triangle warning and prompt for credentials on execution. This is a known issue where n8n doesn't correctly restore credential references during import — the credentials themselves are not lost. Solution:

1. Click the TTLock node to enter the node editor
2. Click the back button in the top-left corner or click blank space on the canvas to exit
3. The red triangle warning will disappear and the node returns to normal

How to test after importing the example workflow?

1. Complete credential configuration (TTLock + SMTP email credentials)
2. Modify email addresses in email nodes
3. Activate the workflow
4. Send POST requests using curl or Postman:

curl -X POST http://your-n8n-address/randomPasscode \
  -H "Content-Type: application/json" \
  -d '{"lockId": "your-lock-id", "keyboardPwdType": 3, "startDate": "2026-05-07 09:00:00"}'

See Workflow Examples for details.

Don't need email notifications?

You can delete the Email-Success and Email-Failure nodes directly, and connect the IF judgment node output to the Respond node.

Other

Which n8n versions are supported?

Requires n8n >= 1.0.0. Using the latest stable version is recommended for best compatibility.