GymControl icon

GymControl

Handle your GymControl instance

Actions91

Overview

This node integrates with the GymControl API to retrieve information about devices associated with specific notification topics. The "Get From Topic" operation under the "Device" resource fetches devices that are linked to a given topic, which is useful for scenarios where you want to target or analyze devices subscribed to particular notification channels.

Practical examples include:

  • Fetching all devices subscribed to a promotional topic to send targeted notifications.
  • Retrieving device details for a specific topic to monitor engagement or troubleshoot delivery issues.

Properties

Name Meaning
Show Complete Response When enabled, returns the full API response instead of just the main data payload.
Topic The notification topic to get devices from. Can be selected by ID or from a searchable list.

Output

The node outputs JSON data containing the devices associated with the specified topic. If "Show Complete Response" is false, the output will typically be a filtered or simplified version of the API response focusing on relevant device information. If true, the entire raw response from the GymControl API is returned.

The node does not explicitly handle binary data output.

Dependencies

  • Requires an API key credential for authenticating requests to the GymControl API.
  • The base URL and API key must be configured in the node's credentials.
  • The node uses HTTP GET requests to endpoints such as /notification/topics and related device endpoints.

Troubleshooting

  • Authentication errors: Ensure the API key credential is correctly set up and has sufficient permissions.
  • Invalid topic ID: Selecting a non-existent or incorrect topic ID will result in empty or error responses. Use the provided search functionality to select valid topics.
  • Network issues: Verify network connectivity to the GymControl API endpoint.
  • Unexpected response structure: If the API changes, the node might return unexpected data; enabling "Show Complete Response" can help debug.

Links and References

  • GymControl API documentation (not included in source code, please refer to official GymControl resources)
  • n8n documentation on creating custom nodes and using resource locators for dynamic lists

Discussion