• 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 Edit

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.

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