Job Posting

The process detailed on the Job Post Marketplace Integration page involves the push notification step and its response. The high-level process involves sending a POST containing a system ID and the information about the job to be posted, and then expecting a reply providing the Platform with a link that is used to direct the user to the appropriate URL to complete the job posting process. The following outlines the process for posting a job to the Web.

What does the event do?: 

The Job Post Event occurs when the user navigates to the Source tab on a Job Profile inside iCIMS. From the Source tab, the user will then first access the Career Portal Posting panel to post a job to an iCIMS Career Portal, and will then access the Job Board Posting panel to post a job to a Partner's site. (Note that the job must be posted to at least one iCIMS Career Portal before the user can post it to a Partner's site.) 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 finish the transaction. 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:

The partner may issue a Web Service request to obtain additional details about the job in question.

The server should acknowledge the response with any of the following HTTP response codes:

• HTTP 303 See Other
• HTTP 400 Bad Request

The criteria for issuing these responses should be as follows:

• 303 See Other: The job post initiation request was successful, and the user should be redirected to the specified URL to complete the process.
• 400 Bad Request: The job post initiation request was not successful. Must be accompanied by a message to be displayed to the user.

Additionally, a JSON message should be returned with the following parameters:

• technicalMessage: a message specifying the technical outcome
• userMessage: a user-friendly message that may be displayed, indicating the outcome

Example:

iCIMS -> Job Post Partner:

POST /JobPost/iCIMS/iCIMS.asp HTTP/1.1
Host: import.example.com
Content-Type: application/json;charset=UTF-8;charset=UTF-8
Content-Length: 248
Link: api.icims.com/customers/1234/jobs/1289;rel="job";title="Job Profile",
api.icims.com/customers/1234/people/400;rel="user";title="Posting User"
Date: Fri,06 Dec 2012 16:25:14 GMT

{
                "systemId":"1289",
                "portalUrl":"jobs-customer.iCIMS.com/jobs/1289/login",
                “eventType”:“JobPostToWebEvent”,
                "customerId":"1234",
                “userId”:“400”
}

Use Cases: 

Job Post

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