Description

@starhunter/n8n-nodes-graphql

This is an n8n community node that integrates with Starhunter in your n8n workflows.

Starhunter is a customer relationship management (CRM) system designed for recruiting and talent management. This node allows you to automate interactions with persons, candidates, employees, emails, project candidates, and tasks in Starhunter.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

Person

• Get Birthdays: Retrieve persons whose birthday falls on a specific date (today or a custom date in MM-DD format)
• Get by ID: Retrieve a single person by their ID
• Search: Search for persons by name (partial match supported)

Candidate

• Search: Search for candidates by ID, name, or birth date

Employee

• Get Current: Get the employee record for the currently authenticated user
• Search: Search for employees by ID or name

Email

• Log: Log an email activity in Starhunter (records sender, recipient, subject, and body)

Project Candidate

• Get by Status Change Date: Retrieve project candidates whose status changed a specified number of days ago

Task

• Create: Create a new task with optional deadline, assignee, and target entity

Credentials

To use this node, you need to authenticate with your Starhunter instance using an API access token.

Prerequisites

1. Access to a Starhunter instance
2. A valid API access token from your Starhunter account settings

Setting up credentials in n8n

1. In n8n, go to Credentials and click Add Credential
2. Search for Starhunter API
3. Enter the following:
   • Base URL: The base URL of your Starhunter instance (e.g., https://your-company.starhunter.software).
   • Access Token: Your Starhunter API access token
4. Click Save to test the connection

For API documentation, refer to your instance's built-in docs at https://<your-instance>.starhunter.software/Api/docs.

Compatibility

• Minimum n8n version: 1.0.0
• n8n Nodes API version: 1
• AI Tool compatible: Yes (can be used as a tool in n8n AI workflows)

Tested with n8n version 1.x.

Usage

Example: Birthday notifications

Create a workflow that runs daily to fetch persons with birthdays today and send notification emails or Slack messages to your team.

1. Add a Schedule Trigger node set to run daily
2. Add the Starhunter node with:
   • Resource: Person
   • Operation: Get Birthdays
   • Use Today: enabled
3. Connect to an Email or Slack node to send notifications

Example: Log emails to CRM

Automatically log emails sent through your workflow back to Starhunter for tracking purposes.

1. After sending an email in your workflow, add the Starhunter node
2. Configure with:
   • Resource: Email
   • Operation: Log
   • Map the from, to, subject, and body fields from your email node

Example: Track candidate status changes

Monitor candidates who changed status a specific number of days ago for follow-up actions.

1. Add a Schedule Trigger node
2. Add the Starhunter node with:
   • Resource: Project Candidate
   • Operation: Get by Status Change Date
   • Status: Your target status (e.g., "Ident")
   • Days Ago: Number of days to look back

Resources

• n8n community nodes documentation
• Starhunter

Version history

0.1.1

• Initial public release
• Added publishConfig for npm public access

0.1.0

• Initial release with support for:
  • Person operations (Get Birthdays, Get by ID, Search)
  • Candidate operations (Search)
  • Employee operations (Get Current, Search)
  • Email operations (Log)
  • Project Candidate operations (Get by Status Change Date)
  • Task operations (Create)