The Job Edit event is used by iCIMS to send updated job information to a third party vendor when a user has modified 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.
iCIMS Talent Platform users kick off the Job Edit Event from within the Platform. For more details on this event, see below.
What does the event do?:
The Job Post Edit Event occurs when the user navigates to the Source tab on a Job Profile inside iCIMS, clicks the Job Board Posting panel, and then clicks the link associated with the job posting. This UI interaction will generate a POST request to the external job posting partner, who will then return the URL that can be used to edit the job posting details. The Platform will then launch a page pointed at this URL. 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 |
Example:
iCIMS -> Partner:
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": "ViewJobWebPostEvent",
"systemId": "1209"
}
Use Cases:
Job Edit
The Job Edit event is used by iCIMS to send updated job information to a third party vendor when a user has modified 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.