Search all guides

Reference · Tools

Taiga trigger

Starts a workflow when project management events like issue creation, story updates, or task changes occur in Taiga via webhooks.

Webhook trigger Development v1

The Taiga Trigger fires when a Taiga project reports activity on the resource types you select — issues, tasks, user stories, milestones, wiki pages — filtered to the operations that matter. A typical build is notifying a channel whenever a user story is created in the current sprint.

Works as
Webhook trigger
Tool name
taiga_trigger
Parameters
4
Outputs
Output
Credentials
Taiga
Official docs
Taiga docs docs.taiga.io

What you can build with Taiga

  • Start a workflow when a new issue is created in Taiga.
  • Trigger a notification when a user story is updated.
  • When automate sprint tracking when a milestone changes.
  • When sync task status when a task is deleted in Taiga.
  • When log wiki page changes to an external system.

Overview

Receives webhook notifications from Taiga when project management events occur, such as issue creation, user story updates, task changes, milestone modifications, and wiki page edits. Taiga sends a POST request containing the action performed (create, change, delete), the resource type (issue, userstory, task, milestone, wikipage), the user who performed the action, the timestamp, and the full resource data. Supports filtering by resource type and operation type. The webhook payload includes the complete object data in the data field. Useful for syncing agile project updates, triggering notifications on sprint changes, automating task tracking, and integrating Taiga with other project management or communication tools.

Node Type

Trigger — webhook (receives incoming HTTP callbacks)

Input / Output

DirectionPort(s)
InputNone (trigger node)
OutputOutput

Credentials

This tool requires Taiga credentials. See the Credentials Guide for setup instructions.

Parameters

ParameterTypeRequiredDefaultDescription
Project IDstringYes—The Taiga project ID to listen for events on. You can find the project ID in your Taiga project settings or URL.
ResourcesmultiOptionsYes["all"]Which resource types to listen for. Select “All” to receive events for all resource types.
Options: all, issue, milestone (a sprint), task, userstory, wikipage
OperationsmultiOptionsYes["all"]Which operations to listen for. Select “All” to receive events for all operation types. Note: “Update” maps to the “change” action in Taiga webhooks.
Options: all, create, delete, change (shown in the editor as Update)
Accept Unsigned RequestsbooleanYesfalseRequired. Taiga has an upstream bug (taiga-back#1031) that makes its webhook signature header unverifiable, so this trigger authenticates callers by the secrecy of the webhook URL alone. Turn this on to acknowledge that and start receiving events; while it is off every delivery is rejected with 401.

Output Data

Each accepted event produces one output item:

  • action — the Taiga action, one of create, change or delete
  • type — the resource type the action applied to, e.g. issue, userstory, task, milestone, wikipage
  • by — the Taiga user who performed the action
  • date — the timestamp Taiga recorded for the action
  • data — the full resource object as sent by Taiga
  • _trigger — always taiga_webhook
  • _timestamp — ISO 8601 timestamp of when the event was received
  • _webhookEvent — the resource type and action joined with a dot, e.g. issue.create

Events whose resource type or operation is outside your selection are acknowledged to Taiga but do not start the workflow.

Reference the payload downstream by expression, e.g. {{ $json.data.subject }}.

Example Configuration

Listen for every event on a project:

{
  "type": "taiga_trigger",
  "parameters": {
    "projectId": "12345",
    "resources": ["all"],
    "operations": ["all"]
  }
}

Fire only when a new issue or user story is created:

{
  "type": "taiga_trigger",
  "parameters": {
    "projectId": "12345",
    "resources": ["issue", "userstory"],
    "operations": ["create"]
  }
}

Track sprint (milestone) updates and deletions:

{
  "type": "taiga_trigger",
  "parameters": {
    "projectId": "12345",
    "resources": ["milestone"],
    "operations": ["change", "delete"]
  }
}

Trigger Behavior

  • Activation: When the workflow is activated, a webhook endpoint is registered with the service.
  • Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
  • Payload: The incoming webhook payload is parsed and output as workflow items.
  • Verification: Supports signature verification where applicable.

Tips

Entry point that fires when Taiga sends a webhook for project events. Configure the project ID, select which resource types to listen for (issues, tasks, user stories, milestones, wiki pages, or all), and choose which operations to track (create, update, delete, or all). The webhook payload includes the full resource data, the action performed, and the actor who made the change.

Frequently asked questions

How do I narrow which events fire it?

By resource type and operation. Choose the resource types to listen for and whether to track create, update, delete or all — so the workflow only wakes for what it handles.

What is in the payload?

The full resource data, the action performed, and the actor who made the change, so you can attribute and branch without a follow-up call.

Can it watch every resource type?

Yes — selecting all covers issues, tasks, user stories, milestones and wiki pages in one trigger.

Which credential does it need?

A Taiga credential, the same one the Taiga action node uses.

Build with Taiga

Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Taiga credentials first.

Open BusyBot

Last reviewed . Spotted something wrong? Tell us.