WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

The Panel - Get Card By ID operation in this n8n node retrieves detailed information about a specific card from a panel within the WTS CRM system, using the card's unique identifier. This is useful for workflows that need to fetch and process data related to a particular card, such as displaying card details, extracting custom fields, or integrating with other systems based on card information.

Practical scenarios:

  • Fetching all details of a sales opportunity (card) for reporting or notification purposes.
  • Integrating card data into another system (e.g., syncing with a project management tool).
  • Triggering actions based on the status or content of a specific card.

Properties

Display Name Type Description
Card ID String The unique identifier of the card you want to retrieve.
Include Details Multi-Options Additional details to include in the response. Options: Contacts, CustomFields, PanelTitle, ResponsibleUser, StepPhase, StepTitle.

Property Details

  • Card ID
    Type: String
    Description: Enter the unique ID of the card you wish to look up. This is required.

  • Include Details
    Type: Multi-Options
    Description: Select one or more additional details to be included in the output. Possible options:

    • Contacts
    • CustomFields
    • PanelTitle
    • ResponsibleUser
    • StepPhase
    • StepTitle

Output

The node outputs a single item with a json field containing the card's data as returned by the WTS CRM API. The structure of this object depends on the card's properties and the selected "Include Details" options, but typically includes:

{
  "id": "string",                // Card ID
  "title": "string",             // Card title
  "description": "string",       // Card description
  "stepId": "string",            // Associated step ID
  "panelId": "string",           // Associated panel ID
  "responsibleUserId": "string", // User responsible for the card
  "tagIds": ["string"],          // List of tag IDs
  "contactIds": ["string"],      // List of associated contact IDs
  "monetaryAmount": number,      // Monetary value (if any)
  "customFields": { ... },       // Custom fields (if requested)
  "metadata": { ... },           // Metadata (if present)
  // ...other fields depending on "Include Details"
}
  • If "Include Details" options are selected, the output will contain additional nested objects/arrays corresponding to those selections (e.g., full contact details, custom fields, etc.).

Dependencies

  • External Service: Requires access to the WTS CRM API.
  • API Key: You must configure valid WTS API credentials (wtsApi) in n8n for this node to function.
  • n8n Configuration: No special environment variables beyond standard credential setup.

Troubleshooting

Common Issues:

  • Missing Card ID:
    Error: "CardID is empty, please fill it in"
    Resolution: Ensure you provide a valid Card ID in the input.

  • Invalid Credentials:
    Error: Authentication errors if the API key is missing or incorrect.
    Resolution: Check your WTS API credentials in n8n.

  • API Errors:
    Any error from the WTS CRM API will be surfaced as a node error.
    Resolution: Review the error message for details; check network connectivity and API service status.

Other Tips:

  • If you do not select any "Include Details" options, only basic card information will be returned.
  • Ensure the Card ID exists and is accessible with your credentials.

Links and References

Discussion