Actions11
Overview
The node enables users to create, update, retrieve, and manage "pipes" within an organization on the Pipefy platform. Pipes are workflow containers that organize processes into phases and cards. This node is particularly useful for automating workflow setup and management in Pipefy, such as creating new pipes with specific configurations or updating existing ones programmatically.
Practical examples include:
- Automatically creating a new pipe when a project starts, setting its name, description, color, and permissions.
- Updating pipe details based on changes in organizational requirements.
- Fetching pipe information to integrate with other systems or dashboards.
Properties
| Name | Meaning |
|---|---|
| Organization ID | The identifier of the organization where the pipe will be created. |
| Pipe Name | The name assigned to the pipe. |
| Additional Fields | Optional extra settings for the pipe: |
| - Description: Text describing the pipe. | |
| - Color: Visual theme color of the pipe. Options: Blue, Red, Green, Yellow, Purple, Orange, Pink, Gray. | |
| - Anyone Can Create Cards: Boolean flag indicating if any user can create cards in this pipe. | |
| - Public: Boolean flag indicating if the pipe is publicly accessible. |
Output
The output JSON object represents the newly created pipe's data structure as returned by the Pipefy API. It includes all relevant pipe properties such as its ID, name, description, color, permissions, and other metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Pipefy API.
- Requires an additional API key credential for the n8n Tools API (used internally).
- The node uses GraphQL queries and mutations to interact with the Pipefy service.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Missing Required Fields: Errors occur if mandatory fields like Organization ID or Pipe Name are not provided. Ensure these inputs are set.
- API Authentication Failures: If credentials are invalid or missing, the node will fail to connect to Pipefy. Verify API keys and their permissions.
- Permission Issues: Attempting to create a pipe in an organization without sufficient rights may cause errors.
- Invalid Option Values: Providing unsupported colors or malformed input in additional fields might result in API rejections.
- Network or Service Downtime: Temporary connectivity issues with Pipefy API can cause failures; retry after some time.