Bitrix24 icon

Bitrix24

Interact with Bitrix24 CRM and business platform

Actions290

Overview

This node interacts with the Bitrix24 platform, specifically focusing on calendar-related operations such as retrieving calendar events. The "Get Event" operation under the "Calendar" resource allows users to fetch detailed information about a specific calendar event by providing its unique event ID and the calendar owner's ID.

Common scenarios where this node is beneficial include:

  • Automating workflows that require fetching event details from Bitrix24 calendars.
  • Integrating Bitrix24 calendar events into other systems or dashboards.
  • Monitoring or processing calendar events programmatically based on event data.

For example, a user might use this node to retrieve an event's details to send reminders or update related CRM records automatically.

Properties

Name Meaning
Authentication Method of authenticating with Bitrix24: OAuth2 (recommended), Webhook (simpler but less secure), or API Key authentication.
Type Type of calendar to access: User, Group, or Company calendar.
Owner ID The unique identifier of the calendar owner whose calendar contains the event.
Event ID The unique identifier of the calendar event to retrieve.
Options Additional optional parameters:
- Access Token: Use a specific access token instead of credentials.
- Filter: JSON object to filter results.
- Order: JSON object to specify sort order.

Output

The node outputs a JSON object containing the details of the requested calendar event. This includes all relevant event fields as returned by the Bitrix24 API for the specified event ID. The output structure corresponds directly to the event data model in Bitrix24, typically including fields like event title, start and end times, attendees, description, and other metadata.

If the node supports binary data output (not explicitly shown in the provided code), it would represent attachments or files associated with the event, but this is not indicated here.

Dependencies

  • Requires connection to Bitrix24 via one of the supported authentication methods: OAuth2, Webhook URL, or API Key.
  • Needs proper configuration of credentials within n8n for the chosen authentication method.
  • Relies on Bitrix24 API endpoints to fetch calendar event data.
  • No additional external libraries beyond those bundled with the node are required.

Troubleshooting

  • Common Issues:

    • Invalid or expired authentication tokens can cause authorization failures.
    • Incorrect or missing Owner ID or Event ID will result in errors or empty responses.
    • Network connectivity issues may prevent successful API calls.
  • Error Messages:

    • Errors returned from Bitrix24 API will be propagated; typical messages include "Event not found" if the Event ID is invalid.
    • If the node is set to continue on failure, error details will be included in the output JSON under an error field.
  • Resolutions:

    • Verify that the authentication credentials are valid and have sufficient permissions.
    • Double-check the Owner ID and Event ID values for correctness.
    • Ensure network access to Bitrix24 API endpoints.
    • Use the "Options" property to provide a fresh access token if needed.

Links and References

Discussion