Job section

The <job> element of the XML consists of multiple Core Fields that make up the essential Job object inside the idibu system.

This block only applies to the Add, Repost, and Clone methods.

For the repost and clone methods, the <job> element requires an additional id attribute that identifies the existing Job.

Fields description

XML element	Type restrictions	Required?	Notes
title	String	Yes Minimum 5 characters	The title of the Job.
reference	String (alphanumeric)	Yes Minimum 4 characters	The reference code of the Job. Ideally, should be unique per Client account. Cannot be changed on repost.
description	String	Yes Minimum 200 characters	The full main body of the Job, HTML supported. Provide one block of text and avoid plain-text newlines - encode them as <br/> instead. Refer to this article for more info.
startdate	Date Format: YYYY-MM-DD	Yes	When the candidate will start working.
duration	String	No	How long will the candidate's work arrangement last.
salarymin	Number Up to two decimals allowed	Yes	The minimum salary.
salarymax	Number Up to two decimals allowed Must be equal to or greater than salarymin	Yes	The maximum salary.
salaryper:value	String (enum) Accepted values: annum month week day hour	Yes	The pay cycle for the remuneration package. Must be provided as a value attribute of the <salaryper> element.
salaryextras	String	No	Extra benefits.
currency	String (enum) Accepted values obtainable via the currencies/available call	Yes	The ISO-3 currency code. Use the custom-currencies webservice to control and obtain the available ones for the given Client account.
jobtype:id	Integer (enum) Accepted values: 1 - Contract 2 - Permanent 4 - Temporary	Yes	Employment type. Must be provided as an id attribute of the <jobtype> element.
job_time	Integer (enum) Accepted values: 1 - Part-time 2 - Full-time	Yes	Working hours.
category:id	Integer (enum) Accepted values available here	Yes	idibu's core industry code. Must be provided as an id attribute of the <category> element.
location:id	String (enum) Accepted values available here	Yes	idibu's core two-letter country code. Must be provided as an id attribute of the <location> element.
sublocation:id	Integer Accepted values obtainable via the locations/find call	Yes	idibu's core location ID. Only locations that belong under the country code specified in the location field will be accepted. Must be provided as an id attribute of the <sublocation> element.
publish	Date and time Format: YYYY-MM-DD or YYYY-MM-DD HH:mm	No	You can queue the Posts to be sent out to Portals in the future; otherwise, they will be queued for immediate posting. Please note that the timestamp must be provided in London time.
app_url	String (URL)	No	URL of an external page to which candidates will be redirected instead of using the Portal's default application functionality. This is a Dynamic Core Field.
salaryOverride	String	No	Textual description of the salary. On most Portals, this will replace the display of the full salary information while still utilising the other salary fields for search. This is a Dynamic Core Field.
startDateOverride	String	No	Textual description of when the candidate would begin working. On most Portals, this will replace the date provided in the startdate Core Field. This is a Dynamic Core Field.
sender:id	String (enum) Accepted values obtainable via the User Management webservice	Yes	Either a standalone <sender> element with an id attribute (recommended); or a parent element (see the Sender info section for more details). Cannot be changed on repost.

Format

  <job id="[integer]"> <!-- include the id attribute only for the 'repost' and 'clone' methods -->
    <title>[string]</title>
    <reference>[string]</reference>
    <description>[string]</description>
    <startdate>[string:date]</startdate>
    <duration>[string]</duration>
    <salarymin>[string:numeric]</salarymin>
    <salarymax>[string:numeric]</salarymax>
    <salaryper value="[annum|hour|day|week|month]"/>
    <salaryextras>[string]</salaryextras>
    <currency>[string:iso3]</currency>
    <jobtype id="[1|2|4]"/>
    <job_time>[1|2]</job_time>
    <category id="[integer]"/>
    <location id="[integer]"/>
    <sublocation id="[integer]"/>
    <publish>[string:date]</publish>
    <app_url>[string:url]</app_url>
    <salaryOverride>[string]</salaryOverride>
    <startDateOverride>[string]</startDateOverride>
    <sender id="[integer]"/>
  </job>

Example

  <job id="12345">
    <title><![CDATA[Job Title]]></title>
    <reference><![CDATA[WH6-QRD]]></reference>
    <description><![CDATA[Job<br/>Description]]></description>
    <startdate>2025-07-01</startdate>
    <duration>1 month</duration>
    <salarymin>12.34</salarymin>
    <salarymax>56.78</salarymax>
    <salaryper value="hour"/>
    <salaryextras><![CDATA[Job benefits]]></salaryextras>
    <currency>USD</currency>
    <jobtype id="1"/>
    <job_time>2</job_time>
    <category id="31"/>
    <location id="GB"/>
    <sublocation id="1024195"/>
    <publish>2025-06-15</publish>
    <app_url><![CDATA[https://www.idibu.com]]></app_url>
    <salaryOverride><![CDATA[Textual salary override]]></salaryOverride>
    <startDateOverride><![CDATA[Textual start date override]]></startDateOverride>
    <sender id="56789"/>
  </job>