Single Step – Update Job

Our Business Rule

  1. Once a job is active, the job title, job reference number and location cannot be altered.
  2. A job can only be refreshed once every 72 hours.

To update a job using a single service call, send a HTTP POST request to the following URL supplying your credentials and the XML representation of the updated job.

Important notice:

  • All mandatory fields must be re-submitted even if they are not being modified. The service will error if mandatory fields are missing on job update.
  • Any non-mandatory fields must be re-submitted even if they are not being updated. The service will assume any missing fields are not required and removed from the database.

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

Mandatory HTTP headers

Content-Type: application/xml

Request body

<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>PUT</operationType>
            <job>
                <id>729999</id>
                <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>

                    <minSalary>11111</minSalary>

                    <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>
                <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>
                <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>
            </job>
        </jobOperation>
    </jobOperations>
</jobFeed>

Upon success, the server responds with HTTP 200 OK status code and an XML representation containing a reference to the updated 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/729999">
                <ns2:refId>729999</ns2:refId>
            </ns2:original>
            <ns2:operationStatus>put successful</ns2:operationStatus>
            <ns2:jobFeedApiKey>12f987fc-6ea1-1234-af54-0e23465a0123</ns2:jobFeedApiKey>
        </ns2:job>
    </ns2:jobs>
</ns2:jobFeedResult>