Close Sidebar
Description

The Job Unpost event is used by iCIMS to send job information to a third party vendor when a user selects to un-post an externally posted job in the iCIMS Platform.  This event is most commonly used by iCIMS clients wishing to send jobs to third party aggregators.

API Examples

iCIMS Talent Platform users kick off the Job Unpost Event from within the Platform. For more details on this event, see below.

What does the event do?: 

The Job Unpost Event occurs when the user navigates to the Source tab on a Job Profile inside iCIMS, clicks the Job Board Posting panel. The user will then select the posting(s) that they wish to remove and click the Cancel Post icon.  This UI interaction will generate a POST request to the external job posting partner, who will then remove the posting(s). The Partner can respond with a message to the user indicate success. The payload will be a JSON message containing the following parameters used to describe the request:

Parameter iCIMS Field Mapping Purpose
systemId Job System ID Specifies the job to be posted. May be used to query the job by ID using existing Web Services at api.icims.com
eventType Event Type Specifies event type, which can be JobPostToWebEvent or JobUnpostToWebEvent
customerId Customer ID Specifies the ID of the customer
userId User System ID Specifies the user who initiated the request 

The event type (parameter eventType) is now modified to read as JobUnpostToWebEvent.The process for unposting a job is the same as a job post, with the following differences:

  1. The portalURL parameter is no longer present.
  2. The partner should reply with HTTP 200 OK instead of HTTP 303 See Other.
  3. The link url field will call out the ID of the Job to be Unposted. 
Example: 

iCIMS -> Partner (1):

POST /1.0/event HTTP/1.1
Connection: close
Link: http://providertest.icims.com/customers/1234/jobs/1209;rel="job";title="Job Profile",http://providertest.icims.com/customers/1234/people/121;rel="user";title="Posting User",
Content-Length: 92
Content-Type: application/json
Content-Encoding: gzip
Host: icims.api.jobtarget.com
User-Agent: Apache-HttpClient/4.2.1 (java 1.5)
Accept-Encoding: gzip,deflate

{
    "customerId": "1234",
    "userId": "121",
    "eventType": "JobUnpostToWebEvent",
    "systemId": "1209"
}

Use Cases: 

Job Unpost

The Job Unpost event is used by iCIMS to send job information to a third party vendor when a user selects to un-post an externally posted job in the iCIMS platform.  This event is most commonly used by iCIMS clients wishing to send jobs to third party aggregators.

Associated Products