@zurdai/n8n-nodes-personalfinder

This is an n8n community node that provides complete integration with the PersonalFinder API.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Open n8n
2. Go to Settings > Community Nodes
3. Select Install
4. Enter @zurdai/n8n-nodes-personalfinder
5. Agree to risks and install

Manual Installation

cd ~/.n8n/custom
npm install @zurdai/n8n-nodes-personalfinder

Then restart n8n.

Operations

This node provides complete access to PersonalFinder API functions organized into 6 main resources, plus event triggers:

Triggers

The PersonalFinder Trigger node allows you to automatically react to events:

• New Match Created - Triggers when AI calculates new matches
• New Interest Received - Triggers when someone shows interest
• Interest Status Changed - Triggers when an interest status updates
• New Job Seeker Registered - Triggers when a new job seeker signs up
• New Employer Registered - Triggers when a new employer signs up
• New Swipe Action - Triggers on swipe events (like/dislike)

1. Employer (Arbeitgeber)

• Create
• Get
• Get Many
• Update

2. Job Seeker (Arbeitsuchende)

• Create
• Delete
• Get
• Get Many
• Update

3. Matching & Swipe

• Calculate Matches (KI)
• Get All Matches
• Get Matches for Employer
• Get Matches for Job Seeker
• List Interests
• Get Interest by ID
• Update Interest Status
• Track Swipe (like/dislike)
• Get Swipe History
• Get Swipe Stats

4. Email Queue

• Get All
• Send
• Get Statistics

5. Time Tracking (Zeiterfassung)

• Create
• Delete
• Get for Job Seeker
• Get Statistics
• Update

6. Statistics (Statistiken)

• Get All Statistics
• Count Employers
• Count Job Seekers

Credentials

This node requires PersonalFinder API credentials.

How to get credentials:

1. In n8n, go to Credentials > New
2. Search for "Personal Finder API"
3. Enter your API password (contact PersonalFinder to get your API password)
4. Enter the base URL: https://pfaeapi.personal-finder.ch
5. Save

The credentials will be used automatically for all API requests.

Compatibility

• Minimum n8n version: 0.190.0
• Tested with n8n version: 1.0.0+

Usage

Basic Example: List All Employers

1. Add the PersonalFinder node to your workflow
2. Select Resource: Employer (Arbeitgeber)
3. Select Operation: Get Many
4. Execute

Advanced Example: Automated Matching with Triggers

Workflow with Trigger:

1. PersonalFinder Trigger node: Listen for "New Match Created"
2. Filter node: Only matches with score > 80
3. PersonalFinder node: Get Job Seeker details
4. PersonalFinder node: Send Email to employer

This workflow automatically notifies employers when high-quality matches are found.

Traditional Workflow Example

Manual Workflow:

1. PersonalFinder node: Calculate Matches
2. PersonalFinder node: Get Matches for Employer (ID: 1)
3. PersonalFinder node: Track Swipe (like the top candidate)
4. PersonalFinder node: Send Email

This workflow calculates matches, retrieves the best candidates, tracks a like action, and sends an email.

Using with Input Data

The node can process input data from previous nodes:

{
  "firstname": "Max",
  "lastname": "Mustermann",
  "email": "max@example.com",
  "phone": "+41 79 123 45 67"
}

Pass this to the Job Seeker > Create operation.

Resources

• n8n community nodes documentation
• PersonalFinder API Repository
• PersonalFinder n8n Workflows

Development

Build

npm run build

Lint

npm run lint

Format

npm run format

License

MIT

Support

For issues and questions:

• GitHub Issues: https://github.com/zurd46/n8n-nodes-personalfinder/issues
• Email: info@personal-finder.ch