Job API Documentation | Single Step, Create new Job

Single Step – Create new Job

To create a new job and make live immediately using a single web service call, send a HTTP POST request to the following URL supplying your credentials and the XML representation of the new entry.

This method of creating a new job will use the automatic job allocation method for making the job live by default. To disable automatic job allocation set turnAutoDeallocationOff flag to true.

POST https://core.ws.efinancialcareers.com/v1/jobfeeds

Mandatory HTTP headers

Content-Type: application/xml

Request body
Example of Job Feed with just mandatory fields

<jobFeed xsi:schemaLocation="http://efinancialcareers.com/schema jobfeed.xsd" xmlns="http://efinancialcareers.com/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<providerLogin>
<apiKey>${apiKey}</apiKey>
<trustedAccountApiKey>${trustedAccountApiKey}</trustedAccountApiKey>
<password>${password}</password>
</providerLogin>
<allocationMethod>default</allocationMethod>
<turnAutoDeallocationOff>false</turnAutoDeallocationOff>
</header>
<jobOperations>
<jobOperation>
<operationType>POST</operationType>
<job>
<defaultDescription lang="EN">
<title>Senior Java Developer</title>
<description>A leading online company are looking for an exceptional Java developer to join them to work on a new greenfield project.</description>
<summary>Java developer - greenfield project in London UK.</summary>
<salaryDescription>60,000 basic + benefits + bonus</salaryDescription>
</defaultDescription>
<positionType>PERMANENT</positionType>
<employmentType>FULL_TIME</employmentType>
<location>
<refId>5133135</refId>
</location>
<brand>
<refId>125</refId>
</brand>
<team>
<refId>124</refId>
</team>
<primarySector>
<sectorCode>DEBT_FIXED_INCOME</sectorCode>
<subSectorCode>DEBT_FIXED_INCOME__SALES_TRADING</subSectorCode>
</primarySector>
<applicationMethod>EXTERNAL_APPLICATION</applicationMethod>
<externalApplicationURL>http://www.example.com/apply</externalApplicationURL>
</job>
</jobOperation>
</jobOperations>
</jobFeed>

Example of Job Feed with several non-mandatory fields

<maxSalary>22222</maxSalary>
<workPermitRequirements>UK Work Permit</workPermitRequirements>
</defaultDescription>
<positionType>PERMANENT</positionType>
<employmentType>FULL_TIME</employmentType>
<yearsExperience>SEVEN_TEN_YEARS_EXPERIENCE</yearsExperience>
<salaryBand>SIXTH_TIER</salaryBand>
<salaryCurrency>GBP</salaryCurrency>

<workArrangementType>HYBRID</workArrangementType>

<customExpirationDt>2025-05-12</customExpirationDt>
<jobReference>Testjob Ref 2</jobReference>
<originalLocation>
<latitude>51.508128895289</latitude>
<longitude>-0.12800500000003012</longitude>
<locationName>London, England</locationName>
<isoCityCode/>
<isoCountryCode>EN</isoCountryCode>
<zip/>
</originalLocation>
<brand>
<refId>125</refId>
</brand>
<team>
<refId>124</refId>
</team>
<primarySector>
<sectorCode>DEBT_FIXED_INCOME</sectorCode>
<subSectorCode>DEBT_FIXED_INCOME__SALES_TRADING</subSectorCode>
</primarySector>
<secondarySector>
<sectorCode>CONSULTANCY</sectorCode>
<subSectorCode>CONSULTANCY__N_A</subSectorCode>
</secondarySector>
<tertiarySector>
<sectorCode>CONSULTANCY</sectorCode>
<subSectorCode>CONSULTANCY__N_A</subSectorCode>
</tertiarySector>
<jobCustomFields>
<jobCustomField>
<fieldName>firstCustomVariables</fieldName>
<fieldValue>ValueForCustomVariables</fieldValue>
</jobCustomField>
<jobCustomField>
<fieldName>secondCustomVariables</fieldName>
<fieldValue>ValueForCustomVariables</fieldValue>
</jobCustomField>
</jobCustomFields>
<applicationMethod>EMAIL</applicationMethod>
<autoReply>false</autoReply>
<screenQuestionnaire>false</screenQuestionnaire>
<contactDetails>
<contactFirstName>Test firstname</contactFirstName>
<contactLastName>Test lastname</contactLastName>
<contactEmail>[email protected]</contactEmail>
<contactPhone>0123456789</contactPhone>
<contactFax>45353453</contactFax>
<contactCompanyName>Test Company</contactCompanyName>
<contactAddress1 display="false">Address 1</contactAddress1>
<contactAddress2 display="false">Address 2</contactAddress2>
<contactAddress3 display="false">Address 3</contactAddress3>
<contactCity display="false">City</contactCity>
<contactRegion display="false">Region</contactRegion>
<contactPostCode display="false">Postcode</contactPostCode>
<contactCountry display="false">England</contactCountry>
<contactURL>http://www.test.com</contactURL>
<displayBrandImage>true</displayBrandImage>
</contactDetails>
<jobTemplate>
<refId>1</refId>
</jobTemplate>
</job>
</jobOperation>
</jobOperations>
</jobFeed>

POST https://core.ws.efinancialcareers.com/v1/jobs/2/allocation

Upon success, the server responds with HTTP 200 OK status code and an XML representation containing a reference to the newly created job.

<ns2:jobFeedResult xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema" xmlns:ns2="http://efinancialcareers.com/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns2:jobs>
<ns2:job>
<ns2:original href="https://backoffice.efinancialcareers.com/legacyJob/922134">
<ns2:refId>922134</ns2:refId>
</ns2:original>
<ns2:expirationDate>2014-01-31T00:00:00.000Z</ns2:expirationDate>
<ns2:operationStatus>post successful</ns2:operationStatus>
<ns2:jobFeedApiKey>e457edb8-7bcf-2ea9-8690-9999c98d3c4</ns2:jobFeedApiKey>
</ns2:job>
</ns2:jobs>
</ns2:jobFeedResult>

eFinancialCareers

Work for eFinancialCareers

Editorial Content

Recruiters