• iCIMS Corporate Site
  • iCIMS Partners
  • Additional Resources
  • Recent Updates
  • FAQ
  • Login
  • GETTING STARTED
    • Getting Started
    • Integration Approval Process
    • How-To Videos
    • Acceptable Use Policy
    • Terms of Use
    • Release Notes
  • API
    • Licenses
    • Connecting, Authenticating, and Identity
    • Authenticating API Calls with OAuth 2.0
    • HMAC
    • Error Handling
    • Error Reporting Standard for Vendors
    • Field Types
  • Standard Integrations
    • Assessments
    • Candidate Matching
    • Candidate Ranking
    • Document Management
    • Data Analytics and Reporting
    • Human Capital Management
    • I-9 & E-Verify
    • Job Advertising
    • Job Posting
    • Partner Screening
    • Reference Checks
    • Tax Credits
    • Video Interviewing
  • Prime Integrations
    • Prime Assessments
    • Prime Background Screen
      • Implementation
  • Endpoints
    • Binary Collection Fields
    • Binary Files
    • Collection Fields
    • Customers
    • Direct Linking
    • iForms
    • Job Distributor
    • Job Portal API
    • List API
    • Offer API
    • Onboard API
    • Profiles
    • Schema API
    • Search API
    • Workflows
  • Streaming Endpoints
  • Data Models
    • iForms
    • Job
    • Location
    • New Hire Category
    • Onboarding Workflow
    • Person
    • Recruiting Workflow
    • Room
    • Sourcing Workflow
    • Talent Pool
    • Event
    • Validation
  • Integration Events
    • Best Practices
    • Application Complete
    • Job Edit
    • Job Posting
    • Job Unposting
    • Onboard Portal Task
    • Status Flow Update
  • OTHER TECH
    • File-Based Transfers
      • Scheduled Import/Export Licenses
      • Imports
      • Exports
      • File Formatting
      • Import File Examples
    • SAML
    • Standard XML Feed for Job Boards
  • Forum

Search form

Developer Resources
  • Getting Started
  • API
  • Standard Integrations
  • Prime Integrations
  • Endpoints
  • Streaming Endpoints
  • Data Models
  • Integration Events
    • Best Practices
    • Application Complete
    • Job Edit
    • Job Posting
    • Job Unposting
    • Onboard Portal Task
    • Status Flow Update
  • OTHER TECHNOLOGY
  • FAQ

Job Unpost

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 rel 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.

Do you have any questions or feedback regarding iCIMS' API documentation? Email the team
See Recent Site Updates

© 2023 iCIMS, Inc. All rights reserved.
Privacy Notice | Terms of Use