Starhunter n8n Node - Overview of all available actions

Modified on Tue, 10 Feb at 12:41 PM

Overview

The Starhunter n8n Node offers 7 resource categories with a total of 13 operations that allow you to automate your recruiting processes. This overview explains each action with practical use cases.

1. Person (Contacts)

Manage person master data in Starhunter.

Get Birthdays - Get Birthdays

What does this action do?
Retrieves all people who have a birthday on a specific date.

Use case:

Send automatic birthday emails to candidates and employees
Daily Slack notification with today's birthdays
Create monthly birthday list for the team

Parameters:

Use Today (Required): When enabled, retrieves today's birthdays
Date (Optional): Alternative date in MM-DD format (e.g. "12-24" for December 24th)

Get by ID - Get Person by ID

What does this action do?
Retrieves the complete data of a single person based on their Starhunter ID.

Parameters:

Person ID (Required): The unique ID of the person in Starhunter

Search - Search People

What does this action do?
Searches the database for people based on their name.

Parameters:

Name (Required): Search term (substring search possible)
Limit (Optional): Maximum number of results (default: 50)
Offset (Optional): Starting point for pagination

2. Candidate (Candidates)

Search - Search Candidates

What does this action do?
Searches for candidates based on various criteria and also returns contact history.

Parameters:

Candidate ID (Optional): Direct search by ID
Name (Optional): Search by first or last name
Limit (Optional): Maximum number of results
Offset (Optional): Starting point for pagination

Note: At least one search criterion must be specified.

3. Employee (Employees)

Get Current - Get Current User

What does this action do?
Retrieves the employee record of the user whose API token is being used.

Use case:

Personalize workflows ("This action was performed by...")
Generate automatic signatures or sender information

Search - Search Employees

Parameters:

Employee ID (Optional): Direct search by ID
Name (Optional): Search by name

4. Email (Email Logging)

Log - Log Email

What does this action do?
Stores an email activity in the Starhunter history so it can be tracked in the CRM.

Use case:

Automatically document all emails sent via n8n in Starhunter
Track email communication with candidates
Maintain complete contact history

Parameters:

From (Required): Sender email address
To (Required): Recipient email address
Subject (Required): Email subject
Body (Required): Email content (text or HTML)

Tip: Use expressions {{ $json.from }} to use data from previous nodes.

5. Project (Projects)

Search - Search Projects

Parameters:

Status (Optional): Project status
Limit (Optional): Maximum number of results
Offset (Optional): Starting point for pagination

6. Project Candidate (Project Candidates)

The most important resource for recruiting automation.

Add - Add Candidate to Project

What does this action do?
Adds a candidate to a project (= create application).

Use case:

Automatically create incoming applications from external sources
Add candidates from talent pools to new projects
Bulk assignment of candidates to projects

Parameters:

Project ID (Required): ID of the project
Candidate ID (Required): ID of the candidate
Presentation Status (Optional): Initial status
Comment (Optional): Note about the assignment

Get By Status Change Date - Get by Status Change Date

What does this action do?
Retrieves all project candidates whose status changed X days ago.

Use case:

Follow-up reminders: "Candidates in 'Interview scheduled' status for 7 days"
Automatic escalation for too long processing time
Reporting: "How many candidates were rejected last week?"

Parameters:

Status (Required): The status to check
Days Ago (Required): Number of days back (e.g. 7 = "7 days ago")
Limit (Optional): Maximum number of results

? Tip: Ideal for SLA monitoring and automatic reminders.

Update Status - Update Status

What does this action do?
Changes the presentation status of a candidate in a project.

Parameters:

Project Candidate ID (Required): ID of the project-candidate assignment
Presentation Status (Required): New status
Comment (Optional): Comment on the status change

7. Task (Tasks)

Create - Create Task

What does this action do?
Creates a new task in Starhunter.

Use case:

Create automatic reminders for recruiters
Create follow-up tasks after certain events
Automatically generate onboarding checklists

Parameters:

Title (Required): Task title
Description (Optional): Detailed description
Deadline (Optional): Due date (Format: YYYY-MM-DD)
Assignee ID (Optional): ID of the responsible employee
Target Entity Type (Optional): Type of target entity
Target Entity ID (Optional): ID of target entity

Popular Workflow Ideas

Automatic Birthday Greetings

Schedule Trigger (daily 8 AM)
  → Starhunter: Get Birthdays (today)
  → Loop over results
    → Gmail: Send birthday email
    → Starhunter: Log Email

Email Tracking

Gmail Trigger: Email sent
  → Filter: To candidates?
  → Starhunter: Log Email

Follow-up Reminders

Schedule Trigger (every Monday)
  → Starhunter: Get By Status Change Date
    Status = "Interview scheduled"
    Days Ago = 14
  → Starhunter: Create Task (Follow-up)
  → Slack: Notification

Status Synchronization

Webhook: Event from video interview tool
  → Starhunter: Search Candidate
  → Starhunter: Update Status
  → Gmail: Confirmation to candidate
  → Starhunter: Log Email

Best Practices

✅ Recommendations

Always log emails: Use "Email Log" after every email send for complete traceability
Error handling: Use n8n Error Triggers to be notified of problems
Avoid duplicates: Always search for existing records before creating new ones
Mind pagination: For large data volumes, use Limit/Offset for multiple passes
Check status names: Pay attention to exact spelling of status names (case-sensitive)

Frequently Asked Questions (FAQ)

❓ Can I add multiple candidates to a project at once?

Yes, use a Loop node to iterate over a list of candidates and add each one individually.

❓ How do I find the ID of a candidate/project?

Use the corresponding Search operation. The ID is included in the return data.

❓ What happens if a candidate is already in a project?

The "Add to Project" operation will return an error. Check beforehand whether the candidate is already assigned.

❓ Can I log emails with attachments?

The "Log Email" operation currently only stores text content. Attachments must be uploaded separately in Starhunter.

❓ How many requests can I make per minute?

There are standard rate limits. For very frequent requests, implement delays between operations.

❓ Does the node work with Starhunter On-Premise?

Yes, simply enter the URL of your On-Premise instance as the Base URL.

Technical Details

API Type: GraphQL
Authentication: Bearer Token
Endpoint: {baseUrl}/Api/graphql
Package Version: 0.2.1
n8n API Version: 1

Next Steps

Try out the various operations
Create your first own workflow
Read the Setup Guide if you haven't already
Visit the official n8n documentation

Need Help?

Read the n8n Community posts
Report bugs on GitHub