ProjectFlow Trigger
AI-generatedSummary
Starts a workflow when selected item events (created, updated, moved, deleted) occur in a chosen ProjectFlow project, by registering a webhook on that project when the workflow is activated.
Inputs
- authentication — Credential type: Personal Token (projectFlowTokenApi, default) or OAuth2 (projectFlowOAuth2Api). Both supply the base URL used for API calls.
- projectId (required) — Project to watch, chosen from a list loaded from /api/v1/projects or set by expression. You must be the project owner to register webhooks.
- events (required) — One or more of item.created, item.updated, item.moved, item.deleted. Defaults to item.created.
Output shape
One workflow item per incoming webhook POST, built from the request body (the ProjectFlow event payload) via returnJsonArray.
On activation, POSTs to /api/v1/projects/{projectId}/webhooks with the n8n webhook URL and events, and stores the returned webhook id and secret in workflow static data. On deactivation, DELETEs that webhook. Incoming requests are verified by HMAC-SHA256 of the JSON-stringified body against the x-webhook-signature header. Invalid signatures are silently dropped (no workflow run). Verification is skipped if no secret is stored. The exact payload fields are not defined in the node. The signature is computed over re-serialized JSON, not the raw body, so it could mismatch if serialization differs.
Examples
Example 1: Post a Slack message whenever a new item is created in a project.
Authentication: Personal Token; Project: select your project; Events: Item Created. Connect to a Slack node.
Example 2: Sync changes to an external tracker for updates, moves, and deletions.
Project: select your project; Events: Item Updated, Item Moved, Item Deleted. Follow with a Switch node on the event type.