Tolgee Trigger icon

Tolgee Trigger

Triggers when activity occurs in Tolgee project

Overview

This node is a trigger for Tolgee, a localization and translation management platform. It activates when specific activities occur within a selected Tolgee project. The node periodically polls the Tolgee API to detect new events related to translation workflows, such as key creation, suggestion acceptance, glossary updates, and many other activity types.

Common scenarios where this node is beneficial include:

  • Automating workflows based on translation or localization events, e.g., notifying teams when a translation suggestion is accepted.
  • Integrating Tolgee activity data into other systems like Slack, email, or project management tools.
  • Triggering downstream processes in n8n when certain translation-related changes happen, such as new keys being created or tasks updated.

Practical example:

  • When a new translation key is created in Tolgee, this node triggers and can start a workflow that sends a notification to translators or updates documentation automatically.

Properties

Name Meaning
Project Name or ID Select the Tolgee project to monitor by name or ID. You can choose from a list loaded dynamically or specify an ID using an expression.
Event Types Choose one or more activity types to listen for. Examples include "Auto Translate", "Key Created", "Suggestion Accepted", "Task Closed", "Translation Label Updated", and many others. If none are selected, all event types are considered.
Poll Interval (Seconds) How often (in seconds) the node polls the Tolgee API for new activities. Default is 30 seconds.

Output

The node outputs JSON data representing Tolgee activity events. Each output item contains detailed information about a single activity, including:

  • projectId: The ID of the Tolgee project where the event occurred.
  • eventType: The type of activity event (e.g., "CREATE_KEY", "TASK_CLOSE").
  • timestamp: The timestamp of the event.
  • revisionId: Identifier for the revision associated with the event.
  • modifiedEntities: Entities modified by the event.
  • Other event-specific fields as returned by the Tolgee API.

The output is structured as an array of objects, each corresponding to one activity event detected since the last poll.

The node does not output binary data.

Dependencies

  • Requires an API key credential for Tolgee with appropriate scopes to access project activities.
  • Needs the Tolgee API domain URL configured in credentials.
  • Uses the Tolgee REST API endpoint /v2/projects/{projectId}/activity to fetch recent activities.
  • Requires network connectivity to the Tolgee service.

Troubleshooting

  • Failed to load projects: This error occurs if the node cannot retrieve the list of projects from Tolgee. Check that the API key and domain are correctly configured and that the API key has permission to view projects.
  • API key missing required scopes: The node validates that the API key includes necessary scopes such as viewing projects, translations, keys, and activity. If scopes are missing, update the API key permissions accordingly.
  • Polling errors: Network issues or invalid credentials may cause polling failures. Verify credentials and network access.
  • No events triggered: Ensure the selected project ID is correct and that the event types filter matches actual activity occurring in Tolgee. If no event types are selected, all events are monitored.

Links and References

Discussion