Pipefy icon

Pipefy

Interact with Pipefy API

Actions32

Overview

This node operation allows you to add a comment to an existing card in Pipefy, a workflow and process management platform. It is useful when you want to programmatically append notes, feedback, or updates to a card as part of an automated workflow.

Typical scenarios include:

  • Automatically adding status updates or remarks to cards based on external triggers.
  • Logging communication or decisions related to a card without manual intervention.
  • Integrating comments from other systems into Pipefy cards for centralized tracking.

For example, after a customer support ticket is updated in another system, this node can add a comment to the corresponding Pipefy card with the latest information.

Properties

Name Meaning
Comment The text content of the comment to add to the specified card

Output

The output JSON contains the newly created comment object with the following fields:

  • id: The unique identifier of the comment.
  • text: The text content of the comment that was added.
  • created_at: Timestamp indicating when the comment was created.

Example output JSON structure:

{
  "id": "123456",
  "text": "This is the comment text.",
  "created_at": "2024-01-01T12:00:00Z"
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Pipefy GraphQL API.
  • The node sends GraphQL mutation requests to https://api.pipefy.com/graphql.
  • Proper permissions are needed on the Pipefy account to add comments to cards.

Troubleshooting

  • Common issues:

    • Invalid or missing card ID: Ensure the card ID provided exists and is accessible.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or API downtime: Check connectivity and Pipefy service status.

  • Error messages:

    • "Field 'card_id' is required": The card ID parameter was not provided or empty.
    • "Unauthorized" or "Authentication failed": The API key credential is invalid or expired.
    • "Card not found": The specified card ID does not exist or is inaccessible.

  • Resolutions:

    • Double-check input parameters for correctness.
    • Reconfigure or update the API key credential.
    • Confirm the card ID by retrieving card details before adding a comment.

Links and References

Discussion