Skip to main content

Building the posting XML

A full jobposting XML consists of the following sections:

  • Method: the action to trigger with the request.
  • Config section: controls some aspects of the interface and user experience related to the posting process.
  • Job section: the main part that defines all the core Job information as well as, optionally, generates all Posts.
    • Core Fields: such as job title, description, location, or salary - constitute a Job object which can then be posted out to various destinations called Portals.
    • Dynamic Core Fields: meant to be used similarly to Core Fields, but connect to specific Extra Fields, for certain Portals only.
    • Sender Info: identifies the User who will own the Job and related Posts and Candidates.
    • Posts section: specifies the posting destinations (Portals) and data specific to each (Duration and Extra Fields).

The main, root XML element for every request is <idibu>; all subsequently documented elements then go under it.

Method​

The XML element allowing to specify one of the below actions is <method>, and it is entirely standalone, with no further sub-elements.

The API allows to run various types of actions in order to create new or manage existing job postings:

  • add: creates a new Job and, if applicable, corresponding Posts to selected Portals.
  • repost: updates an existing Job and, if applicable, creates corresponding Posts to selected Portals (re-using any unchanged values).
  • clone: creates a new Job (and, if applicable, corresponding Posts to selected Portals) based on an existing Job (re-using any unchanged values).
  • quickrepost: creates Posts of an existing Job to selected Portals without modifying or configuring any Job or Extra Fields data.
  • cancel: allows to remove selected Posts that are pending in the Posting Queue and have not yet reached their Portals.
  • delete: deletes selected live (successfully posted) Posts from their Portals.

Next articles will go over how the XML is constructed and what elements are used for each of those methods.

Add, Repost, and Clone​

These three methods utilize the full XML structure that allows to perform a complete configuration of the Job and its corresponding Posts.

The basic outline of the XML format for these methods is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<idibu>
  <method>["add"|"repost"|"clone"]</method>
  <config>
    [...] <!-- all applicable Config fields -->
  </config>
  <job>
    [...] <!-- Core Fields and Dynamic Core Fields -->
    <sender>
      [...] <!-- Sender Info to create a new User or identify an existing one -->
    </sender>
    <posts>
      [...] <!-- Portals to post to along with their Extra Fields; if this data is missing, a PCP will be generated -->
    </posts>
  </job>
</idibu>

The subsequent articles will discuss the above format; the quickrepost, cancel, and delete methods use a simplified structure specific to each method.