Amocrm icon

Amocrm

Consume AmoCRM API
Join our community

Actions28

Overview

This node allows users to create leads in AmoCRM, a customer relationship management platform. It supports creating multiple leads at once, either by providing structured input fields or by supplying a JSON string of lead data. This node is useful for automating lead creation workflows, such as importing leads from other systems, capturing leads from web forms, or bulk lead generation.

Use Case Examples

  1. Automatically create new leads in AmoCRM when a form is submitted on a website.
  2. Bulk import leads from a CSV file by converting the data to JSON and using this node to create them in AmoCRM.
  3. Create leads with detailed information including pipeline status, responsible users, custom fields, and embedded tags or contacts.

Properties

Name Meaning
Authentication Method used to authenticate with AmoCRM API, either Long Lived Token or OAuth2.
JSON Parameters Toggle to specify if lead data is provided as a JSON string or as structured fields.
Stringifyed Array of Objects A JSON string representing an array of lead objects, used when JSON Parameters is true.
Leads Collection of lead entries to create, each with properties like name, price, pipeline, status, users, dates, loss reason, custom fields, and embedded tags, contacts, and companies.

Output

JSON

  • id - ID of the created lead.
  • name - Name of the created lead.
  • price - Price associated with the lead.
  • pipeline_id - ID of the pipeline the lead belongs to.
  • status_id - ID of the lead status.
  • created_by - User ID who created the lead.
  • updated_by - User ID who last updated the lead.
  • responsible_user_id - User ID responsible for the lead.
  • closed_at - Date and time when the lead was closed.
  • created_at - Date and time when the lead was created.
  • updated_at - Date and time when the lead was last updated.
  • loss_reason_id - ID of the reason for lead loss, if applicable.
  • custom_fields_values - Custom fields and their values associated with the lead.
  • _embedded
    • tags - Tags associated with the lead.
    • contacts - Contacts linked to the lead.
    • companies - Companies linked to the lead.

Dependencies

  • Requires AmoCRM API access with either a long-lived token or OAuth2 authentication.

Troubleshooting

  • Ensure the authentication method selected matches the credentials provided; incorrect tokens or expired OAuth2 tokens will cause authentication failures.
  • When using JSON Parameters, ensure the JSON string is correctly formatted and represents an array of lead objects.
  • If using structured fields, ensure required fields like pipeline_id and status_id are valid and exist in AmoCRM.
  • Custom fields and embedded entities must correspond to existing fields and entities in AmoCRM; otherwise, the API may reject the request.

Links

Discussion