Planka

Interact with Planka API

Actions46

Overview

The Planka n8n node's "👤 USER" resource with the "🔍 Get User" operation retrieves detailed information about a specific user from a Planka instance, given their User ID. This is useful in automation scenarios where you need to fetch user details for reporting, validation, or further workflow steps (e.g., sending notifications, checking permissions, or synchronizing user data).

Example use cases:

Fetching user profile information to enrich records in another system.
Validating if a user exists before assigning them to a project or card.
Auditing user details as part of an administrative workflow.

Properties

Name	Type	Meaning
User ID	String	The unique identifier of the user whose information you want to retrieve. This is required.

Output

The output will be a single item (or one per input item) with a json field containing the user's details as returned by the Planka API. The structure typically includes fields such as:

{
  "id": "string",
  "name": "string",
  "email": "string",
  "username": "string",
  "phone": "string",
  "organization": "string",
  "language": "string",
  "subscribeToOwnCards": true,
  "isAdmin": false,
  // ...other user-specific fields provided by Planka
}

Note: The exact structure depends on the Planka API response.

Dependencies

External Service: Requires access to a running Planka instance with its REST API enabled.
Authentication: Needs valid Planka API credentials configured in n8n under the credential type plankaApi.
n8n Configuration: No special environment variables are needed beyond standard credential setup.

Troubleshooting

Common issues:

Invalid User ID: If the provided User ID does not exist, the node may return an error or an empty result.
Authentication errors: If the API credentials are missing or incorrect, you may see errors like "401 Unauthorized" or "403 Forbidden".
Connection issues: Network problems or incorrect Planka API URL can cause connection failures.

Error messages and resolutions:

"User not found": Check that the User ID is correct and exists in your Planka instance.
"401 Unauthorized" or "403 Forbidden": Verify your API credentials in n8n.
"An unknown error occurred": Inspect the full error message in the node output for more details; check network connectivity and API endpoint configuration.