Pulse Talent icon

Pulse Talent

Talent resource from Pulse API

Actions24

Overview

The node interacts with the Pulse API to manage and retrieve talent-related data. Specifically, for the Skill resource with the Get Skills List operation, it fetches a list of skills from the Pulse system. This is useful in scenarios where you want to integrate skill data into workflows, such as syncing skills with other HR systems, filtering talents by skills, or displaying skill inventories.

Practical examples:

  • Retrieve a paginated list of skills to display in a dashboard.
  • Include related talent information alongside skills for enriched reporting.
  • Apply filters and sorting to get specific subsets of skills based on criteria like organization or relevance.

Properties

Name Meaning
Include Related Resources Select related resources to include in the response. Options: Talent (includes talent data related to skills).
Additional Fields Collection of optional parameters to customize the request:
- Sort Sort order string, e.g., -relevance to sort by relevance descending.
- Page Number Pagination page number (requires page size to be set).
- Page Size Number of items per page for pagination.
- Filters Multiple filter key-value pairs to narrow down results. Each filter has:
- Filter Key: The field to filter by (e.g., organization_id).
- Values: Comma-separated values for the filter (e.g., 1,2,3).
- Fields Specify which fields to return grouped by field keys. Each group includes:
- Field Key: The group identifier (e.g., iam/organizations/people_directories).
- Fields: Comma-separated list of field names to include (e.g., id,name).

Output

The node outputs JSON data containing the list of skills retrieved from the Pulse API. The structure typically includes an array of skill objects, each representing a skill with its properties such as ID, name, description, and possibly related talent data if requested via the "Include Related Resources" option.

If binary data were involved (not indicated here), it would represent files or attachments related to skills, but this node focuses on JSON data output.

Dependencies

  • Requires connection to the Pulse API via an API key credential configured in n8n.
  • The node depends on the Pulse API helper utilities bundled within the node's codebase to handle authentication and API requests.
  • No additional external services are required beyond the Pulse API.

Troubleshooting

  • Common Issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Incorrect filter keys or values may result in empty responses or errors.
    • Pagination parameters without proper page size can lead to unexpected results.
    • Requesting unsupported related resources in "Include Related Resources" may cause errors.

  • Error Messages:

    • "The operation "getSkillsList" is not supported for resource "skill"!" — indicates a mismatch between selected operation and resource; ensure correct selections.
    • "The resource "skill" is not supported!" — suggests an invalid resource parameter; verify input.
    • API errors returned from Pulse (e.g., rate limits, invalid filters) will be passed through; check API documentation for resolution.

  • Resolutions:

    • Verify API credentials and permissions.
    • Double-check property values, especially filters and pagination.
    • Use the "Continue On Fail" option in n8n to handle partial failures gracefully.

Links and References

Discussion