@zurdai/n8n-nodes-jobroom

This is an n8n community node that lets you interact with the JobRoom API from Switzerland in your n8n workflows.

JobRoom is the official Swiss job platform operated by the State Secretariat for Economic Affairs (SECO). This node allows you to programmatically create, manage, and search job advertisements.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes Installation

1. Go to Settings > Community Nodes
2. Select Install
3. Enter @zurdai/n8n-nodes-jobroom in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

After installation, the JobRoom node will be available in your n8n instance.

Credentials

To use this node, you need:

1. Personal Finder API Key - Contact [email protected] to obtain an API key
2. JobRoom API credentials - Request access from JobRoom:
   • Username
   • Password
   • Access to Staging environment (testing)
   • Access to Production environment (when activated)

Setting up credentials in n8n

1. In n8n, go to Credentials > New
2. Search for JobRoom API
3. Enter your credentials:
   • Personal Finder API Key: Your API key from Personal Finder (required)
   • Environment: Choose between Staging (for testing) or Production
   • Username: Your JobRoom API username
   • Password: Your JobRoom API password
4. Click Save

Important: Without a valid Personal Finder API Key, the node will not work. Contact [email protected] to obtain your key.

Operations

Job Advertisement

Create

Create a new job advertisement in the JobRoom system.

Required fields:

• Contact information (salutation, name, phone, email)
• Job descriptions (language, title, description)
• Company details (name, address)
• Employment details (dates, workload percentage)
• Location (city, postal code, country)
• Occupation (AVAM occupation code)
• Apply channel (contact methods)
• Publication settings (dates, display options)

Get

Retrieve a single job advertisement by its ID.

Get Many

Retrieve all job advertisements owned by your account. Supports pagination.

Search

Search for job advertisements by status. Available statuses:

• INSPECTING
• REJECTED
• PUBLISHED_RESTRICTED
• PUBLISHED_PUBLIC
• CANCELLED
• ARCHIVED

Cancel

Cancel a job advertisement by its ID.

Example Usage

Create a Job Advertisement

{
  "contact": {
    "salutation": "MR",
    "firstName": "Max",
    "lastName": "Mustermann",
    "phone": "+41 44 123 45 67",
    "email": "[email protected]"
  },
  "jobDescriptions": [
    {
      "languageIsoCode": "de",
      "title": "Software Engineer",
      "description": "Entwicklung von innovativen Softwarelösungen"
    }
  ],
  "company": {
    "name": "Beispiel AG",
    "street": "Musterstrasse",
    "houseNumber": "1",
    "postalCode": "8000",
    "city": "Zürich",
    "countryIsoCode": "CH"
  },
  "employment": {
    "startDate": "2025-01-01",
    "endDate": null,
    "shortEmployment": false,
    "immediately": true,
    "permanent": true,
    "workloadPercentageMin": 80,
    "workloadPercentageMax": 100
  },
  "location": {
    "city": "Zürich",
    "postalCode": "8000",
    "countryIsoCode": "CH"
  },
  "occupation": {
    "avamOccupationCode": "22213"
  },
  "applyChannel": {
    "emailAddress": "[email protected]",
    "phoneNumber": "+41 44 123 45 67"
  },
  "publication": {
    "startDate": "2025-01-01",
    "endDate": "2025-03-31",
    "euresDisplay": false,
    "euresAnonymous": false,
    "publicDisplay": true,
    "restrictedDisplay": true,
    "companyAnonymous": false
  }
}

Resources

• JobRoom API Documentation
• n8n community nodes documentation
• JobRoom Official Website

Version History

1.0.0

• Initial release
• Support for all JobRoom API v1 endpoints
• Create, Get, List, Search, and Cancel operations
• Basic Authentication with username/password
• Support for both Staging and Production environments

License

MIT