Description
n8n-nodes-amocrm
amoCRM (Kommo) nodes for n8n — with dropdowns that read your own account.
Pipelines, stages, users, tags, catalogs and every custom field you have configured are loaded
live from the account the credential points at. You pick “Won” from a list instead of remembering
that it is status 142, and a custom field renders the input its type deserves: a checkbox for a
flag, a date picker for a date, your own list of options for a select.
Why this node
Requests are counted, so the integration does not get shut out. amoCRM allows an
integration about seven requests per second, and answers sustained abuse with a 403 — not a
slowdown, a refusal. Before each call this node reserves a slot in a one-second window, and
that window is shared by every workflow in the n8n process, so ten parallel executions add up
to one budget instead of ten. A 429 is retried with backoff and honours Retry-After; a 403
is never retried, because retrying is exactly what turns a throttle into a ban. The rate is a
credential setting, so an account whose plan allows more can be told about it.
Failures come back in words you can act on. amoCRM says “Request validation failed” and
leaves the rest to you. Here a 401 says which credential to renew, a 402 says the
subscription lapsed rather than the token being wrong, a 403 spells out the three unrelated
things it can mean, a 429 names the setting to lower, and a rejected field is reported by
name together with the input item that carried it.
Dropdowns read your account. Pipelines, stages scoped to the pipeline you picked, users,
task types, loss reasons, tags, catalogs and their elements, event types, customer statuses
and segments — all loaded from the account the credential points at. You pick “Won” from a
list instead of remembering that it is status 142. Those lookups are cached for a minute,
per credential, so reopening a node or changing a dependent field costs nothing — and two
dropdowns asking for the same list share one request rather than making two.
Custom fields get a real editor. The field picker carries the field’s type with it, so
the value input below changes to match: a checkbox for a flag, a date picker for a date, your
own options for a select or multi-select, a component-by-component form for an address.
Structured types amoCRM defines but no form can draw — legal entities, invoice items, files —
take JSON. There is also an explicit Clear Field switch, because “empty” and “erase” are
different instructions in amoCRM and confusing them costs data.
Entities are searchable, not just numeric. Where a lead, contact, company or customer is
needed, the picker searches the account by name as you type — and the same field also accepts
an ID, or a URL pasted straight out of the browser.
Bulk writes report item by item. Raise Batch Size on a create or update and the node
groups input items into single requests. Each element carries a request_id, so a rejection
points at the input item that caused it instead of failing the whole batch anonymously.
The trigger speaks amoCRM’s dialect. Webhooks arrive as application/x-www-form-urlencoded
with PHP-style bracket keys (leads[status][0][id]=123). The trigger decodes that into
ordinary nested JSON and emits one item per changed entity rather than one per HTTP request,
which is what a workflow actually wants to iterate over. Subscriptions are created when the
workflow is activated and removed when it is deactivated.
The whole account is reachable. Leads, contacts, companies, customers, tasks, notes,
files, catalogs and catalog elements, custom fields and their groups, pipelines and stages,
links, tags, events, unsorted, salesbots, calls, conversations, users and webhooks — and a
Custom Request operation for anything not modelled yet, through the same authenticated and
rate-limited transport. amoCRM and Kommo are one product behind one API, and both are served by
this node.
Conversations close the loop the trigger opens. The trigger already reports an incoming
message; the Talk resource is what answers it. List the conversations still in work, read a
client’s history, reply into the messenger they wrote from, and close the conversation or hand it
to the NPS bot — which is what an AI agent in n8n needs before it can hold a conversation at all.
Two ways in, and credentials that stay put. Authenticate with a long-lived token from a
private integration, or with OAuth2 when one integration serves several accounts. The account
address is a subdomain plus a domain from a closed list, enforced again in the node’s own
code, and both credential types are pinned out of the HTTP Request node — so nobody who can
edit a credential can point its token at an address of their own.
Usable as an AI agent tool. Every operation carries the description a model reads when it
picks a tool, and Simplify adds a flat custom_fields object keyed by field name next to
amoCRM’s raw field_id array, so a model does not have to decode your account’s field IDs to
read a record.
Contents
- Why this node
- Installation
- Credentials
- Nodes
- Using this node with an AI agent
- amoCRM behaviour worth knowing
- Compatibility
- Development
- Feedback and bugs
- Licence
Installation
In n8n, go to Settings → Community nodes → Install and enter:
@zenland-dev/n8n-nodes-amocrm
Or install it into a self-hosted instance by hand:
npm install @zenland-dev/n8n-nodes-amocrm
Credentials
amoCRM offers two ways in. Both are supported; pick by how many accounts you need to reach.
Access token — recommended for a single account
A long-lived token from a private integration. It does not rotate, so there is nothing to refresh
and nothing to break at three in the morning.
1. Sign in to amoCRM as an administrator.
2. Settings → Integrations → Create integration, and choose a private integration.
3. Fill in the form and save. Leaving the access checkboxes untouched grants every scope; tick
Files as well if you plan to upload attachments.
4. Open the integration card’s Keys and scopes tab and generate a long-lived token.
5. In n8n, create an amoCRM Access Token API credential:
– Subdomain — the part in front of the domain: mycompany for mycompany.amocrm.ru.
– Domain — pick amocrm.ru, amocrm.com or kommo.com.
– Access Token — the token you just generated.
– Requests per Second — leave at 7 unless the account plan allows an integration more.
The token has an expiry date you chose when generating it, up to five years. Anyone holding it has
your whole account until then, so treat it like a password.
> The address is a subdomain plus a fixed domain on purpose. A credential holds a secret that
> n8n attaches to every request it makes with it, and whoever may edit that credential decides
> where those requests go — without ever seeing the secret, which n8n masks on read and restores on
> save. A free-form address would therefore be enough to walk the token out of the building. Here
> the domain comes from a closed list, the subdomain is reduced to the characters a host may
> contain, and the same rule is applied again in the node’s own code. These credentials are also
> pinned so they cannot be selected in an HTTP Request node.
OAuth2 — for integrations serving several accounts
1. Create the integration in amoCRM with “Available for everyone” ticked.
2. Copy n8n’s OAuth Redirect URL from the credential screen into the integration’s Redirect URI.
3. In n8n, create an amoCRM OAuth2 API credential, fill in Subdomain, Domain, Client ID
and Client Secret, then click Connect.
The address must be filled in before connecting: amoCRM hosts its token endpoint on the
account’s own domain, so n8n cannot build the request without it.
> amoCRM has no per-request scopes. What the integration may touch is chosen on the integration
> card inside amoCRM, not by n8n.
Nodes
amoCRM
| Resource | Operations |
| ————— | ———————————————————————————————————————– |
| Lead | Create · Create Complex · Get · Get Many · Update |
| Contact | Create · Get · Get Many · Update |
| Company | Create · Get · Get Many · Update |
| Customer | Create · Get · Get Many · Update |
| Task | Create · Complete · Get · Get Many · Update |
| Note | Create · Get · Get Many · Update |
| Tag | Create · Get Many |
| Link | Link · Unlink · Get Many |
| Call | Create |
| Talk | Get · Get Many · Get Messages · Send Message · Close |
| Event | Get · Get Many |
| Unsorted | Create · Get · Get Many · Accept · Decline · Link · Get Summary |
| Catalog | Create · Get · Get Many · Update |
| Catalog Element | Create · Get · Get Many · Update |
| Pipeline | Create · Get · Get Many · Update · Delete — and the same five for stages |
| Custom Field | Create · Get · Get Many · Update · Delete — and the same five for field groups |
| User | Get · Get Many |
| Account | Get |
| Webhook | Subscribe · Unsubscribe · Get Many |
| File | Upload · Attach to Entity · Add as Note · Download · Get · Get Many · Get Linked Entities · Detach From Entity · Delete |
| Salesbot | Run · Stop · Get · Get Many |
| Custom Request | Request |
Ninety-four operations across twenty-two resources.
> There is no Delete for leads, contacts or companies — API v4 has no such route.
> amoCRM’s own interface deletes them through a session-authenticated endpoint no
> integration can use. A node offering “Delete” here would have to do something else
> and call it deletion, so this one does not offer it.
Create Complex writes a lead together with its contact and company in one request, and it
is the only way to reach amoCRM’s duplicate control: a contact whose phone or e-mail is already
in the account is merged into rather than created a second time, and the answer says which lead,
contact and company the write resolved to. One condition — duplicate control has to be switched on
for the integration in amoCRM; where it is not, the write still succeeds, unchecked.
Talk is a conversation with a client in a messenger — WhatsApp, Telegram, whichever channel
brought them in — including one opened by somebody else’s integration. Listing, reading and
closing work on both amoCRM and Kommo.
Get Messages and Send Message are documented by Kommo only. The routes are present on
amoCRM.ru as well, but answer 403 there: they are gated behind a chat permission that amoCRM
does not offer integrations, so listing an account’s conversations succeeds while reading one of
them refuses (checked on 8 September 2026). On Kommo, sending consumes the
Chats API add-on quota (Trial 100 a month, Pro and Enterprise 500); reading the history does not.
Create, Create Complex and Update on leads, Create and Update on contacts, companies and
customers, Create, Update and Complete on tasks, and Create on calls, accept a Batch Size:
raise it and the node groups input items into single requests.
Custom Request is the release valve: any path, any method, through the same authenticated and
rate-limited transport. Anything amoCRM adds tomorrow is reachable today.
amoCRM Trigger
Subscribes to amoCRM webhooks when the workflow is activated and unsubscribes when it is
deactivated. Events cover leads, contacts, companies, customers, tasks, notes, talks and messages.
amoCRM posts webhooks as application/x-www-form-urlencoded with PHP-style bracket keys
(leads[status][0][id]=123), not as JSON. The trigger decodes that into ordinary nested JSON, and
by default emits one item per changed entity rather than one per HTTP request — which is what a
workflow almost always wants to iterate over.
Using this node with an AI agent
The node is exposed to n8n’s AI Agent as a tool, and on n8n 2.x nothing has to be switched on
for that. The tool name a model sees is the operation’s action — Create a lead in amoCRM,
Get many tasks in amoCRM, and so on. Four things decide whether it gets the call right.
Pin Resource and Operation yourself, and let the model fill only the data fields. n8n will
accept a $fromAI() placeholder on Resource and Operation, but the model then receives a
free-form string with no list of the twenty-two resources or ninety-four operations to choose
from, and it will invent values like catalog_element. One node per operation you want to
expose is the shape that works — and it is the same shape an MCP Server Trigger needs, one
tool per node.
Turn Simplify on when a model reads the output. amoCRM returns custom fields as
customfieldsvalues: [{ field_id: 123456, values: [{ value: "…" }] }], which forces the model
to decode the account’s field ids to make sense of a record. Simplify adds a flat
custom_fields object keyed by field name alongside the raw array. It is off by default
because it changes the shape of the output.
Leave the entity pickers in their list mode so a name resolves to an id on its own, and
switch a picker to By ID only when the id genuinely comes from earlier data. Pipeline, stage,
responsible user, tag and custom field ids differ from account to account — they are not
guessable, and a model asked for one will guess.
Custom fields take a composite value. The field picker’s value is fieldId::fieldType, for
example 123456::select, and the type half is what makes the matching value input appear. A
bare numeric id leaves that input hidden and the value is written as plain text — harmless for
a text field, wrong for a date, a select or a multiselect.
amoCRM behaviour worth knowing
identify a stage. That is why stage labels are prefixed with the pipeline name.
GET /users and /roles are admin-only. A 403 there usually means the authorising user isnot an administrator, not that the token is wrong.
reads keep working for thirty days.
_embedded.tags overwrites an entity’s whole tag set, so this node writes tagstoadd instead and leaves the rest alone. Use
Removed Tag Names or IDs to take one away, or Replace Tags when overwriting is what
you mean.
on a lead and on a contact — an ID copied from one will not find the other.
iscompleted is false and completetill is in the past. The web interface filters on
status=failed, and API v4 accepts that parameter and ignores it — the answer is the same as
without it. In the node, switch Completed off and set Deadline Before to {{ $now }}.
and completetill is not among them, yet filter[completetill][from] and [to] filter
server-side the way the documented date ranges do. Deadline After and Deadline Before
send them. Since an unrecognised filter key is ignored rather than refused, the symptom of
amoCRM dropping it would be more rows coming back, not an error.
order[complete_till] on an otherwise bare task list fails; add any filter and the same request returns. The node retries a
failed read four times, so the wait is spent before the error surfaces.
that runs the execution, so a single-process instance stays inside one budget, while N
workers get N of them. Divide Requests per Second on the credential by the number of
workers — and leave room for whatever else calls the same account.
Compatibility
Tested against n8n 2.x. Requires Node.js 20.19 or newer, matching n8n’s own requirement.
Development
npm install
npm run build # n8n-node build
npm run lint # n8n-node lint
npm run dev # runs a local n8n with this node loaded
The package ships with no runtime dependencies, as n8n’s community-node rules require.
Feedback and bugs
Bug reports and ideas are welcome — open an issue:
github.com/zenland-dev/n8n-nodes-amocrm/issues.
What makes a report quick to act on:
Missing an endpoint? The Custom Request operation reaches any part of the API in the
meantime — say which one you need and it can be modelled properly, with dropdowns and all.
