Actions20
Contact → List
AI-generatedOverview
This node interacts with the Bitrix24 API to list Contact records. It allows users to retrieve multiple contact entries from their Bitrix24 CRM system, either fetching all records or limiting the number of records returned. Users can also specify which fields to include in the response, optimizing data retrieval for their needs. This is useful for scenarios such as syncing contacts with other systems, generating reports, or processing contact data in workflows.
Use Case Examples
- Retrieve all contacts from Bitrix24 to sync with an external database.
- Fetch a limited number of contacts with specific fields for a marketing campaign.
- List contacts with selected fields to generate a custom report.
Properties
| Name | Meaning |
|---|---|
| Return All | Determines whether to fetch all contact records or limit the number of records returned. |
| Limit | Specifies the maximum number of contact records to retrieve when 'Return All' is false. |
| Select Fields | Allows selection of specific contact fields to include in the response, reducing data volume and focusing on relevant information. |
Output
JSON
result- Array of contact records returned from Bitrix24 API, each containing the requested fields.
Dependencies
- Bitrix24 API credentials including a webhook URL for authentication.
Troubleshooting
- Ensure Bitrix24 API credentials are correctly configured and the webhook URL is valid.
- If the node returns an error about missing credentials or webhook URL, verify the credential setup in n8n.
- When selecting fields, ensure the field names exist in the Bitrix24 Contact resource to avoid invalid field errors.
- If the API limit is reached or the response is empty, check Bitrix24 API usage limits and permissions.
Links
- Bitrix24 CRM Contact List API - Official Bitrix24 documentation for listing contacts via API.