Creating a New Job

To create a new job, send an authorised HTTP POST request, and supply the XML representation of the new entry in the HTTP body:

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

Mandatory HTTP headers:

Content-Type: application/xml

Authorization: EfcAuth realm=”EFC”, token=”522c3c4bd036a69db428ce4274745e9d”

You will note from the XML request below several job details are placed within the <defaultDescription lang=”EN” /> element. You can retrieve the list of language codes we support currently by using the API call described here.

Request body

Example of Job with just mandatory fields:

<job xmlns="http://efinancialcareers.com/schema">
    <defaultDescription lang="DE">
        <title>Job ONE in German</title>
        <description>Unser Kunde ist ein expandierendes Investmentbank derzeit, die ihre Kreditkarten Flow-Sales-Team mit einem erfahrenen Vertriebsmitarbeiter entwickeln.</description>
        <summary>Die Zuständigkeiten für diese Gelegenheit gehören</summary>
        <salaryDescription>Basic + Bonus-CD EUR</salaryDescription>

    </defaultDescription>
    <positionType>PERMANENT</positionType>
    <employmentType>FULL_TIME</employmentType>
    <yearsExperience>SEVEN_TEN_YEARS_EXPERIENCE</yearsExperience>
    <salaryBand>SIXTH_TIER</salaryBand>
    <salaryCurrency>GBP</salaryCurrency>
    <location>
        <refId>2643743</refId>
    </location>
    <brand>
        <refId>111</refId>
    </brand>
    <primarySector>
        <sectorCode>DEBT_FIXED_INCOME</sectorCode>
        <subSectorCode>DEBT_FIXED_INCOME__SALES_TRADING</subSectorCode>
    </primarySector>
    <applicationMethod>EMAIL</applicationMethod>
    <autoReply>false</autoReply>
    <screenQuestionnaire>false</screenQuestionnaire>
    <contactDetails>
        <contactEmail>[email protected]</contactEmail>
    </contactDetails>
</job>

Example of Job with several non-mandatory fields:

<job xmlns="http://efinancialcareers.com/schema">
    <defaultDescription lang="DE">
        <title>Job ONE in German</title>
        <description>Unser Kunde ist ein expandierendes Investmentbank derzeit, die ihre Kreditkarten Flow-Sales-Team mit einem erfahrenen Vertriebsmitarbeiter entwickeln.</description>
        <summary>Die Zuständigkeiten für diese Gelegenheit gehören</summary>
        <salaryDescription>Basic + Bonus-CD EUR</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</jobReference>
    <location>
        <refId>5133135</refId>
    </location>
    <brand>
        <refId>125</refId>
    </brand>
    <primarySector>
        <sectorCode>DEBT_FIXED_INCOME</sectorCode>
        <subSectorCode>DEBT_FIXED_INCOME__SALES_TRADING</subSectorCode>
    </primarySector>
    <secondarySector>
        <sectorCode>INFORMATION_SERVICES</sectorCode>
        <subSectorCode>INFORMATION_SERVICES__N_A</subSectorCode>
    </secondarySector>
    <tertiarySector>
        <sectorCode>HEDGE_FUNDS</sectorCode>
        <subSectorCode>HEDGE_FUNDS__OTHER</subSectorCode>
    </tertiarySector>
    <jobCustomFields>
        <jobCustomField>
            <fieldName>a</fieldName>
            <fieldValue>b</fieldValue>
        </jobCustomField>
        <jobCustomField>
            <fieldName>c</fieldName>
            <fieldValue>d</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>
        <contactFax>45353453</contactFax>
        <contactCompanyName>Company JN</contactCompanyName>
        <contactAddress1>12 SThree</contactAddress1>
        <contactAddress2>London Road</contactAddress2>
        <contactAddress3>London Street</contactAddress3>
        <contactCity>London</contactCity>
        <contactRegion>South East</contactRegion>
        <contactPostCode>E3 4NL</contactPostCode>
        <contactCountry>England</contactCountry>
        <contactURL>www.test.com</contactURL>
        <displayBrandImage>true</displayBrandImage>
    </contactDetails>
</job>

Upon success, the server responds with HTTP 201 Created status code and an XML representation of the newly created job in the response body(example Job with just mandatory fields):

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:job href="https://core.ws.efinancialcareers.com/v1/jobs/926091" xsi:schemaLocation="http://efinancialcareers.com/schema https://core.ws.efinancialcareers.com/v1/schema">
    <ns2:id>926091</ns2:id>
    <ns2:version>0</ns2:version>
    <ns2:defaultDescription lang="DE">
        <ns2:title>Job ONE in German</ns2:title>
        <ns2:description>Unser Kunde ist ein expandierendes Investmentbank derzeit, die ihre Kreditkarten Flow-Sales-Team mit einem erfahrenen Vertriebsmitarbeiter entwickeln.             </ns2:description>
        <ns2:summary>Die Zuständigkeiten für diese Gelegenheit gehören</ns2:summary>
        <ns2:salaryDescription>Basic + Bonus-CD EUR</ns2:salaryDescription>
    </ns2:defaultDescription>
    <ns2:multiLangDescription />
    <ns2:positionType>PERMANENT</ns2:positionType>
    <ns2:employmentType>FULL_TIME</ns2:employmentType>
    <ns2:yearsExperience>SEVEN_TEN_YEARS_EXPERIENCE</ns2:yearsExperience>
    <ns2:salaryBand>SIXTH_TIER</ns2:salaryBand>
    <ns2:salaryCurrency>GBP</ns2:salaryCurrency>
    <ns2:user href="https://app.ws.efinancialcareers.com/v1/users/168">
        <ns2:refId>168</ns2:refId>
    </ns2:user>
    <ns2:company href="https://app.ws.efinancialcareers.com/v1/companies/66">
        <ns2:refId>66</ns2:refId>
    </ns2:company>
    <ns2:location href="https://app.ws.efinancialcareers.com/v1/locations/2643743">
        <ns2:id>2643743</ns2:id>
        <ns2:name>London</ns2:name>
        <ns2:latitude>51.50853</ns2:latitude>
        <ns2:longitude>-0.12574</ns2:longitude>
        <ns2:parents>
            list of<ns2:location></ns2:location>
        </ns2:parents>
        <ns2:type>CITY</ns2:type>
        <ns2:country>GB</ns2:country>
    </ns2:location>
    <ns2:brand href="https://app.ws.efinancialcareers.com/v1/brands/125">
        <ns2:refId>125</ns2:refId>
    </ns2:brand>
    <ns2:primarySector>
        <ns2:sectorCode>DEBT_FIXED_INCOME</ns2:sectorCode>
        <ns2:subSectorCode>DEBT_FIXED_INCOME__SALES_TRADING</ns2:subSectorCode>
    </ns2:primarySector>
    <ns2:jobCustomFields />
    <ns2:applicationMethod>EMAIL</ns2:applicationMethod>
    <ns2:autoReply>false</ns2:autoReply>
    <ns2:screenQuestionnaire>false</ns2:screenQuestionnaire>
    <ns2:contactDetails>
        <ns2:contactEmail display="true">[email protected]</ns2:contactEmail>
    </ns2:contactDetails>
    <ns2:status>PENDING</ns2:status>
    <ns2:entityStatus>ACTIVE</ns2:entityStatus>
    <ns2:created>2015-02-18T07:31:46.634Z</ns2:created>
    <ns2:updated>2015-02-18T07:31:46.634Z</ns2:updated>
    <ns2:labelTranslations>
        huge list of<ns2:translation>...</ns2:translation>
    </ns2:labelTranslations>
    <ns2:dictTranslations>
        huge list of<ns2:translation>...</ns2:translation>
    </ns2:dictTranslations>
    <ns2:jobTemplate>
        <ns2:id>1</ns2:id>
        <ns2:version>0</ns2:version>
        <ns2:jobTemplateName>Default eFC Template</ns2:jobTemplateName>
    </ns2:jobTemplate>
</ns2:job>

The <contactDetails> element overrides the information we hold on the database. The override information will appear on the right-hand side of the job page as shown below. You can switch between displaying each individual value by toggling the display attribute for each element.