Description

n8n-nodes-cleero

Community node for n8n to integrate with the Cleero API.

• What it does: Manage Cleero Lists from your workflows.
• Auth: OAuth 2.0 (PKCE) via Cleero’s Cognito app — connect from n8n, no client secret required.
• Status: Beta (v0.1.0)

Install

Install via n8n UI (recommended)

• In n8n, go to: Settings → Community Nodes → Install
• Enter: n8n-nodes-cleero
• Confirm the security prompt to allow community nodes.

Self-hosted (CLI)

• Install in your n8n user folder (e.g. ~/.n8n or C:\Users\<you>\.n8n on Windows):
  cd ~/.n8n
  npm install n8n-nodes-cleero- Restart n8n.

Credentials

This node uses Cleero OAuth2 API credentials.

• In n8n, go to: Credentials → New → search for Cleero PKCE OAuth2 API
• Click Connect, then sign in to your Cleero account.

Notes:

• This credential uses OAuth 2.0 with PKCE. No client secret is required.
• Scopes requested: openid email profile
• n8n computes the redirect automatically. Ensure your public URL is set correctly in environment variables:
  • N8N_HOST, N8N_PORT, N8N_PROTOCOL
  • Or set WEBHOOK_URL if behind a reverse proxy.

Using the node

Add a Cleero node to your workflow and choose a resource and operation.

Resource: Lists

• Get Lists

  • Operation: Get Lists
  • Description: Retrieve all lists from Cleero.
  • Output: Array of lists.

• Create List

  • Operation: Create List
  • Description: Create a new list in Cleero.
  • Fields: – Title (string, required) – Prompt (multiline string, required). Suggested template:

  Who we are looking for:
  Based on what parameters:
  What for:

Quickstart example

1. Add Manual Trigger
2. Add Cleero → Resource: List → Operation: Get Lists
3. Select your Cleero PKCE OAuth2 API credentials
4. Click Execute to fetch your lists

To create a list, switch operation to Create List and fill Title, Prompt, Keywords, and Ban Words as needed.

Troubleshooting

• OAuth popup doesn’t redirect back to n8n

  • Check N8N_HOST/N8N_PROTOCOL/N8N_PORT or WEBHOOK_URL is reachable from your browser.
  • Ensure any reverse proxy forwards headers correctly.

• 401/403 errors

  • Reconnect credentials (token may have expired).
  • Confirm your Cleero account has access.

• Behind a sub-path (e.g., /n8n)

  • Set N8N_PATH (e.g., /n8n) and ensure your external URL reflects it.

Development

Local dev

Clone repo

git clone https://github.com/valsydev-corp/n8n-nodes-cleero
cd n8n-nodes-cleero

Install deps

npm install

Lint

npm run lint

Build

npm run buildTo test locally in a running n8n:

• Option A: npm install the built package into your n8n user folder (~/.n8n) and restart n8n.
• Option B: Use npm link between this package and your n8n user folder.

Scripts

• npm run dev – Dev mode (watch/build via n8n node CLI)
• npm run build – Build to dist/
• npm run lint / npm run lint:fix – Lint
• npm run release – Release helper

Resources

• n8n Docs: Community nodes guide
• Issues & feedback: open an issue on the repository
• Cleero Auth docs (placeholder): https://example.com/docs/auth

License

MIT © Valsydev