N8N Tools - Pipefy Pipe icon

N8N Tools - Pipefy Pipe

Create, update, delete, and manage Pipefy pipes with advanced workflow features

Overview

This node enables advanced management of Pipefy pipes and their phases within workflows. Specifically, the "Delete Phase" operation allows users to delete a phase from a pipe by specifying the phase's unique ID. This is useful for automating cleanup or restructuring of pipes in Pipefy without manual intervention.

Practical scenarios include:

  • Automatically removing obsolete or completed phases from a pipe as part of a workflow.
  • Managing pipe lifecycle dynamically based on external triggers or conditions.
  • Integrating Pipefy pipe phase management into broader automation pipelines.

Properties

Name Meaning
Phase ID The unique identifier of the phase to delete. Required for deleting a phase.

Output

The output JSON object contains the following fields:

  • success (boolean): Indicates whether the phase deletion was successful.
  • phaseId (string): The ID of the phase that was requested to be deleted.
  • message (string): A human-readable message indicating success ("Phase deleted successfully") or failure ("Failed to delete phase").

No binary data is output by this operation.

Example output JSON:

{
  "success": true,
  "phaseId": "12345",
  "message": "Phase deleted successfully"
}

Dependencies

  • Requires an API key credential for authenticating with the Pipefy API.
  • Requires an additional API key credential for the n8n Tools API.
  • The node uses GraphQL requests to interact with Pipefy's API endpoints.
  • Proper configuration of these credentials in n8n is necessary for the node to function.

Troubleshooting

  • Common issues:

    • Missing or invalid Phase ID: The node validates that the Phase ID is provided; if missing, it will throw an error.
    • Authentication failures: Ensure that the required API keys are correctly configured and have sufficient permissions.
    • Network or API errors: Temporary connectivity issues or Pipefy API downtime can cause failures.
  • Error messages:

    • "The operation \"deletePhase\" is not supported": This indicates an unsupported operation was selected; verify the operation name.
    • Validation errors such as "Phase ID is required": Provide the correct Phase ID input.
    • API errors returned from Pipefy will be included in the error message; check API credentials and permissions.

Links and References

Discussion