jobroom

n8n node for JobRoom API Switzerland

Package Information

Released: 11/19/2025
Downloads: 1,021 weekly / 1,021 monthly
Latest Version: 1.3.5
Author: Your Name

Available Nodes

JobRoom
No description available

Documentation

@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 info@personal-finder.ch 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 info@personal-finder.ch 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": "max.mustermann@example.com"
  },
  "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": "bewerbung@example.com",
    "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

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

Discussion