Amocrm icon

Amocrm

Consume AmoCRM API

Overview

This node retrieves a list of companies from AmoCRM based on specified filters and options. It supports authentication via Long Lived Token or OAuth2. Users can filter companies by various criteria such as IDs, names, creation and update dates, responsible users, and more. It also allows sorting the results and including related entities like leads, customers, and contacts. The node can return all results or paginate them with a limit and page number.

Use Case Examples

  1. Retrieve all companies created by a specific user within a date range.
  2. Get a paginated list of companies sorted by update date in descending order.
  3. Fetch companies with specific IDs or names and include related contacts and leads.

Properties

Name Meaning
Authentication Method used to authenticate the request to AmoCRM, either Long Lived Token or OAuth2.
Return All Whether to return all matching companies or limit the results to a specified number.
Filter Criteria to filter the list of companies, including query string, company IDs, names, users who created or updated the companies, responsible users, and date ranges for creation, update, and closest task.
Options Additional options for sorting and including related entities in the response.
Page Page number for paginated results, applicable when not returning all results.
Limit Maximum number of results to return per page.

Output

JSON

  • companies - Array of company objects matching the filter criteria.
  • pagination
    • page - Current page number of the results.
    • limit - Maximum number of results per page.
    • total - Total number of companies matching the criteria.

Dependencies

  • AmoCRM API

Troubleshooting

  • Authentication errors due to invalid or expired tokens. Ensure the correct authentication method and valid credentials are used.
  • Incorrect filter parameters may result in no data returned. Verify filter values and formats, especially date ranges and user selections.
  • Pagination issues if page or limit values are out of range. Use valid positive integers for these parameters.
  • API rate limits or connectivity issues may cause request failures. Check network connection and AmoCRM API status.

Links

Discussion