N8N Tools - Pipefy Pipe icon

N8N Tools - Pipefy Pipe

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

Actions11

Pipe → Delete Phase

AI-generated

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