StepStone JobFeed icon

StepStone JobFeed

Interact with StepStone JobFeed API to manage job listings
Join our community

Overview

This node integrates with the StepStone JobFeed API to manage job listings. It supports two main modes:

  • Push mode: Sends a single job listing to StepStone immediately.
  • Pull mode: Generates an XML file containing all job listings from the input data, suitable for bulk export or further processing.

Typical use cases include automating job posting workflows by sending job details directly to StepStone or generating XML feeds for multiple jobs to be uploaded or reviewed externally.

For example, a recruiter can use this node in Push mode to instantly publish a new job opening on StepStone. Alternatively, HR teams can use Pull mode to generate a complete XML feed of all current job openings for archival or batch upload purposes.

Properties

Name Meaning
Feed Type Choose between "Push (Send Single Job)" to send one job listing immediately, or "Pull (Generate XML For All Jobs)" to create an XML feed for all jobs in the input.
Basic Information Contains mandatory job listing details such as Reference ID (unique identifier), Channel (country code like DE, AT, etc.), Language (job language), Job Title, and Company Name.
Categorization Optional categorization IDs including Work Field, Geography, Sector, Contract Type, Work Type, and Experience level to classify the job listing.
Job Details Detailed content sections for the job including Introduction, Tasks, Profile (candidate skills), Benefits, Contact Info, and optional custom titles for each section.
Job Locations Mandatory job location details including Country Code, City, Postal Code, Street Name, and Building Number.
Application Mandatory application method specifying how candidates should apply: Email, URL, or Questionnaire (specific to South Africa). Corresponding contact email or URLs are required based on the chosen method.
Salary Salary information including minimum and maximum salary amounts, currency (EUR, USD, GBP, ZAR), and payment period (per year, month, week, or hour).
Layout Details Visual customization options including up to three header images, a background image, background and headline colors, and an optional YouTube video URL.
Company Details Company-related info such as contract name and product type (mandatory), billing details (order number, cost center, billing address, reference), and recruiter contact details (position, gender, name, email, phone).
Additional Attributes Job listing attributes like Sender ID, Organisation ID (both provided by StepStone), and Action (Insert, Update, Offline, Translate) which applies only in Push mode.
Keywords Comma-separated keywords for the job listing to improve searchability.

Output

  • In Push mode, the node outputs a JSON object containing:

    • success: Boolean indicating if the operation was successful.
    • response: The response from the StepStone API, including status and text.
    • xmlContent: The generated XML string for the single job listing sent.

  • In Pull mode, the node outputs a JSON object with:

    • xml: A complete XML feed string containing all job listings wrapped inside a <jobfeed> root element.

The node does not output binary data.

Dependencies

  • Requires an API key credential with username and password for authenticating against the StepStone JobFeed API.
  • Makes HTTP POST requests to https://jobfeed.stepstone.com/listing/ using form-urlencoded data.
  • No additional external libraries beyond standard n8n workflow dependencies.

Troubleshooting

  • Common issues:

    • Missing mandatory fields such as Reference ID, Channel, Language, Job Title, Company Name, Job Location, or Application Method details will likely cause errors or invalid XML generation.
    • Incorrect or missing API credentials will result in authentication failures.
    • Network issues or StepStone API downtime may cause request failures.

  • Error messages:

    • StepStone API error: <status> <statusText> indicates the HTTP request to StepStone failed. Check credentials, network connectivity, and API availability.
    • Validation errors due to missing required parameters might not be explicitly thrown but will cause the API to reject the submission or produce invalid XML.

  • Resolution tips:

    • Ensure all mandatory properties are filled correctly.
    • Verify API credentials are valid and have necessary permissions.
    • Test connectivity to the StepStone API endpoint.
    • Use Pull mode to generate XML and validate it manually before pushing.

Links and References

Discussion