n8n
The n8n-nodes-pinlyx community node puts your Pinlyx contacts, deals and conversations into n8n workflows: a form submission becomes a contact, a new deal reaches your accounting tool, an inbox conversation feeds the next step. It calls the public API with your API key, so it can do exactly what the key’s scopes allow.
Install the node
Section titled “Install the node”-
In n8n, open Settings › Community Nodes, choose Install and enter
n8n-nodes-pinlyx. On a self-hosted instance you can also runnpm install n8n-nodes-pinlyx. -
In the Pinlyx app, open Settings › Developers and create an API key with the scopes your workflow needs, for example
contacts:readandcontacts:write. API keys are part of the Business plan. -
In n8n, add the node’s credential and paste the key into API Key. Leave Base URL at
https://api.pinlyx.com. -
Add the node to a workflow and pick a Resource and an Operation.
Operations
Section titled “Operations”| Resource | Operation | What it does |
|---|---|---|
| Contact | Create | Adds a contact. At least one of name, username, phone, email or external ID is required. Set External ID so a re-run does not create a second copy. |
| Contact | Get | Reads one contact by ID. |
| Contact | Get Many | Lists contacts, with filters for search, platform, email, external ID and Updated Since for incremental syncs. |
| Contact | Update | Changes fields on a contact. |
| Contact | Delete | Archives a contact. Message history and linked deals stay. |
| Deal | Create | Opens a deal with title, value, currency, stage, probability, expected close date and notes. |
| Deal | Get Many | Lists deals, with filters for stage, contact and a title search. |
| Conversation | Get Many | Lists conversations across your connected channels. |
List operations follow the API’s cursor pagination: turn on Return All to walk every page, or set a limit.
Good to know
Section titled “Good to know”- Scopes are checked by the API. A key without
contacts:writefails Create and Update with a403rather than doing nothing. - A deal cannot be created as Won or Lost, because closing a deal as won books revenue; close it in the panel.
- The Platform field on Create offers more options than the API accepts today. Use Telegram or Email; the other values are rejected with a
400. - Every node run counts against the key’s per-minute rate limit.
- To start a workflow when something happens in Pinlyx, point a Pinlyx webhook at an n8n Webhook trigger node.