Pickaxe icon

Pickaxe

Interact with the Pickaxe APIs

Overview

This node interacts with the Pickaxe API, specifically allowing users to retrieve historical conversation data related to a selected Pickaxe form. It is useful for scenarios where you want to analyze or process past interactions collected via Pickaxe forms, such as customer feedback, support conversations, or survey responses.

A practical example would be fetching the last 10 conversations from a specific Pickaxe form to perform sentiment analysis or generate reports on user engagement.

Properties

Name Meaning
Pickaxe Select a Pickaxe form from a list or specify its ID using an expression.
Limit The maximum number of conversations to return (e.g., 10).
Skip The number of recent conversations to skip (useful for pagination).
Last Days Filter conversations to only include those from the latest specified number of days.

Output

The node outputs JSON data containing the retrieved conversation history from the Pickaxe API. Each item in the output corresponds to a conversation record associated with the selected Pickaxe form.

The output does not include binary data; it focuses on structured JSON representing conversation details such as timestamps, messages, and metadata as provided by the Pickaxe service.

Dependencies

  • Requires an API key credential for authenticating with the Pickaxe API.
  • The node uses OAuth2 authentication configured in n8n credentials.
  • Network access to https://api.pickaxe.co/v1 is necessary.

Troubleshooting

  • Common issues:

    • Authentication failures due to invalid or expired API tokens.
    • Incorrect Pickaxe form ID leading to empty or error responses.
    • Network connectivity problems preventing API calls.
  • Error messages:

    • Unauthorized errors indicate issues with the API key or OAuth2 token; re-authenticate or update credentials.
    • "Not Found" errors may mean the specified Pickaxe form ID does not exist or is inaccessible.
    • Rate limiting or quota exceeded errors require checking Pickaxe API usage limits.

Links and References

Discussion