Pulse Organizations icon

Pulse Organizations

Organizations actions from Pulse API

Actions8

Overview

This node enables managing entries in People Directories within an organization via the Pulse API. Specifically, the "Create People Directory" operation allows users to add a new person entry into a directory associated with an organization. This is useful for maintaining structured contact and role information about individuals involved in various projects or organizational units.

Common scenarios include:

  • Adding new employees or contractors to a company directory.
  • Associating people with specific projects or teams.
  • Managing contact details and roles for client-facing or internal personnel.

For example, you might use this node to create a directory entry for a new project manager, specifying their position, related projects, and additional contact methods like Slack or email.

Properties

Name Meaning
Person ID * The unique identifier of the person to add to the directory.
Organization ID * The unique identifier of the organization where the directory entry will be created.
Tag * The category tag for the directory entry. Options: Production, Account Management, Client.
Position * The role or position of the person within the directory entry. Options depend on the selected Tag and include roles like Production Manager, Client Success Manager, etc.
Project IDs Comma-separated list of project IDs associated with the person. Optional.
Other Contacts Additional contact information as multiple entries, each with a Contact Type (e.g., slack, whatsapp, email) and Contact Value (e.g., URL, phone number).

Output

The node outputs a JSON object representing the newly created people directory entry. This typically includes all submitted fields along with any additional metadata returned by the Pulse API, such as unique identifiers or timestamps.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Pulse API using an API key credential configured in n8n.
  • The node dynamically loads available positions based on the selected Tag, which depends on the Pulse API's predefined roles.

Troubleshooting

  • Missing Required Fields: Ensure that all required properties marked with * (Person ID, Organization ID, Tag, Position) are provided; otherwise, the API call will fail.
  • Invalid Position Selection: Positions are dynamically loaded based on the Tag. If no positions appear, verify that the Tag is correctly set.
  • API Authentication Errors: Confirm that the API key credential is valid and has sufficient permissions to create people directory entries.
  • Malformed Project IDs: Project IDs should be comma-separated strings without extra spaces or invalid characters.
  • Other Contacts Format: Each additional contact must have both a type and a value; missing either may cause errors.

If the node throws an error indicating unsupported operations or resources, verify that the Resource is set to "People Directories" and Operation to "Create People Directory".

Links and References

Discussion