Pulse Organizations icon

Pulse Organizations

Organizations actions from Pulse API

Actions8

Overview

This node allows users to update entries in a People Directory within an organization using the Pulse API. It is designed to modify details of a specific person’s directory entry, such as their position, associated projects, and contact information.

Common scenarios where this node is beneficial include:

  • Keeping employee or contractor directory information up-to-date.
  • Managing organizational roles and project assignments dynamically.
  • Adding or updating alternative contact methods for people in the directory.

For example, you might use this node to update a person's role from "Production Manager" to "Operations Manager," add new project IDs they are involved with, or add additional contact channels like Slack or WhatsApp.

Properties

Name Meaning
Person ID * The unique identifier of the person whose directory entry is being updated.
Organization ID * The unique identifier of the organization to which the person belongs.
People Directory ID * The unique identifier of the specific people directory entry to update.
Tag * The category tag for the directory entry. Options: Production, Account Management, Client.
Position * The position or role of the person within the directory entry. Options depend on the selected Tag.
Project IDs Comma-separated list of project IDs associated with the person. Optional field.
Other Contacts Additional contact information as multiple key-value pairs, e.g., contact type (slack, email) and value (URL, phone number).

*Fields marked with * are required.

The Position options dynamically load based on the selected Tag, ensuring relevant roles are presented for each category.

Output

The node outputs JSON data representing the updated people directory entry. This typically includes confirmation of the updated fields and any metadata returned by the Pulse API after the update operation.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Pulse API via an API key credential configured in n8n.
  • The node depends on the Pulse API helper utilities bundled with the node implementation to perform API calls.
  • Dynamic loading of position options depends on internal logic mapping tags to positions.

Troubleshooting

  • Error: The operation "updatePeopleDirectory" is not supported for resource "peopleDirectories"!
    This indicates a mismatch between the selected operation and resource. Ensure that the resource is set to "People Directories" and the operation to "Update People Directory".

  • Missing required fields error
    Make sure all required properties (Person ID, Organization ID, People Directory ID, Tag, Position) are provided.

  • API authentication errors
    Verify that the API key credential is correctly configured and has sufficient permissions to update people directory entries.

  • Invalid project IDs format
    Project IDs should be provided as a comma-separated string without extra spaces or invalid characters.

Links and References

Discussion