amoCRM integration for comprehensive customer relationship management operations in Axellero workflows.

amoCRM Node

Manage contacts, leads, and companies through the amoCRM API v4 in Axellero workflows with comprehensive CRUD operations.

Available Operations

Contacts: Create, read, update, delete, and search contact records
Leads: Complete lead lifecycle management with status tracking
Companies: Manage company records with advanced filtering

Connection Configuration

Parameter	Type	Required	Description
`subdomain`	TEXT	Yes	Your amoCRM subdomain (e.g., 'company' for company.amocrm.ru)
`accessToken`	TEXT	Yes	OAuth2 access token for amoCRM API authentication

{
  "subdomain": "{{ctx.consts.AMOCRM_SUBDOMAIN}}",
  "accessToken": "{{ctx.consts.AMOCRM_ACCESS_TOKEN}}"
}

Contact Operations

createContact

Create a new contact in amoCRM.

Parameter	Type	Required	Description
`name`	TEXT	Yes	Contact full name
`email`	TEXT	No	Contact email address
`phone`	TEXT	No	Contact phone number

{
  "name": "{{ctx.user.fullName}}",
  "email": "{{ctx.user.email}}",
  "phone": "{{ctx.user.phone}}"
}

getContacts

Retrieve contacts with optional filtering and search.

Parameter	Type	Required	Description
`limit`	INT	No	Maximum contacts to retrieve (1-250)
`query`	TEXT	No	Search query for name, email, or phone

{
  "limit": 50,
  "query": "{{ctx.vars.searchTerm}}"
}

getContact

Retrieve a specific contact by ID.

Parameter	Type	Required	Description
`contactId`	INT	Yes	ID of the contact to retrieve

{
  "contactId": "{{ctx.vars.contactId}}"
}

updateContact

Update an existing contact with detailed field support.

Parameter	Type	Required	Description
`contactId`	INT	Yes	ID of the contact to update
`name`	TEXT	No	Updated contact full name
`firstName`	TEXT	No	Updated contact first name
`lastName`	TEXT	No	Updated contact last name
`email`	TEXT	No	Updated contact email address
`phone`	TEXT	No	Updated contact phone number
`responsibleUserId`	INT	No	Updated responsible user ID

{
  "contactId": "{{ctx.vars.contactId}}",
  "name": "{{ctx.vars.updatedName}}",
  "email": "{{ctx.vars.updatedEmail}}",
  "responsibleUserId": "{{ctx.vars.assignedUserId}}"
}

deleteContact

Delete a contact from amoCRM.

Parameter	Type	Required	Description
`contactId`	INT	Yes	ID of the contact to delete

{
  "contactId": "{{ctx.vars.contactId}}"
}

Lead Operations

createLead

Create a new lead in amoCRM.

Parameter	Type	Required	Description
`name`	TEXT	Yes	Lead name or title
`price`	INT	No	Lead value in account currency
`contactId`	INT	No	ID of associated contact

{
  "name": "{{ctx.vars.projectName}} - {{ctx.user.company}}",
  "price": "{{ctx.vars.dealValue}}",
  "contactId": "{{ctx.vars.contactId}}"
}

getLeads

Retrieve leads with optional filtering.

Parameter	Type	Required	Description
`limit`	INT	No	Maximum leads to retrieve (1-250)
`status`	INT	No	Lead status ID to filter by

{
  "limit": 100,
  "status": "{{ctx.vars.leadStatus}}"
}

getLead

Retrieve a specific lead by ID.

Parameter	Type	Required	Description
`leadId`	INT	Yes	ID of the lead to retrieve

{
  "leadId": "{{ctx.vars.leadId}}"
}

updateLead

Update an existing lead with status and value changes.

Parameter	Type	Required	Description
`leadId`	INT	Yes	ID of the lead to update
`name`	TEXT	No	Updated lead name
`price`	INT	No	Updated lead value
`statusId`	INT	No	Updated status ID

{
  "leadId": "{{ctx.vars.leadId}}",
  "name": "{{ctx.vars.updatedLeadName}}",
  "price": "{{ctx.vars.updatedPrice}}",
  "statusId": "{{ctx.vars.newStatusId}}"
}

deleteLead

Delete a lead from amoCRM.

Parameter	Type	Required	Description
`leadId`	INT	Yes	ID of the lead to delete

{
  "leadId": "{{ctx.vars.leadId}}"
}

Company Operations

getCompanies

Retrieve companies with filtering and pagination.

Parameter	Type	Required	Description
`limit`	INT	No	Maximum companies to retrieve (1-250)
`page`	INT	No	Page number for pagination
`query`	TEXT	No	Search query to filter companies by name

{
  "limit": 50,
  "page": "{{ctx.vars.pageNumber}}",
  "query": "{{ctx.vars.companySearchTerm}}"
}

getCompany

Retrieve a specific company by ID.

Parameter	Type	Required	Description
`companyId`	INT	Yes	ID of the company to retrieve

{
  "companyId": "{{ctx.vars.companyId}}"
}

Workflow Integration

Use workflow context to create dynamic CRM operations:

{
  "name": "Lead from {{ctx.user.source}} - {{ctx.vars.eventType}}",
  "price": "{{ctx.vars.calculatedValue}}",
  "contactId": "{{ctx.nodes.contactCreator.outputs.contactId}}"
}

Response Format

Success Response

{
  "success": true,
  "id": 12345,
  "data": {
    "name": "John Smith",
    "email": "john.smith@example.com"
  }
}

Error Response

{
  "success": false,
  "error": "Contact not found",
  "code": "NOT_FOUND"
}

Use Cases

Lead qualification: Automatically create and update leads based on website activity
Contact synchronization: Sync customer data between systems and amoCRM
Sales automation: Update deal stages and values based on workflow events
Data enrichment: Enhance contact records with additional business information

amoCRM

On this page