• 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
  • OTHER TECHNOLOGY
  • FAQ

Frequently Asked Questions

Below are some of the most common questions regarding iCIMS web services capabilities. Please refer to the answers below if you are in need of assistance.

I am interested in integrating with iCIMS. How do I get started?
What is GZIP?
Why is my payload blank/ Why do I have strange characters in my outbound payload from iCIMS?
How do I decompress the body of my payload?
How can I update a field group entry like a specific background check results or assessment results?
How can I get access to a specific customer?
What is the authorization header?
Why is it important to utilize iCIMS standard field framework?
Does iCIMS support other languages such as HR-XML?
How can I customize my organizations attributes for the mutual clients?
How can I manually test API calls?
How do I make a call?
How do I capture all posted Job details for a specific iCIMS client?
Does iCIMS institute any rate limitations?
I cannot make patch calls using my HTTP library. Is there a workaround?
I am interested in integrating with iCIMS. How do I get started?

Please see the Integrating with iCIMS: Getting Started page.

What is GZIP?

GZIP is a compression language for the purpose of minimizing the size of data transfer between systems.

Why is my payload blank/ Why do I have strange characters in my outbound payload from iCIMS?

All iCIMS outbound messages are in GZIP format.  To read the payload the body of the message needs to be decompressed.

How do I decompress the body of my payload?

This depends on the library that is being used.  We recommend referencing JSON.org for a library of commands specific to your coding language.

How can I update a field group entry like a specific background check results or assessment results?

All field group entries return an entry ID in the response.  This entry ID can then be used to PATCH the prior submission.

How can I get access to a specific customer?

Client ID’s will be communicated at the time of the live integration project.  This information is also included in the payload of the outbound iCIMS messages.

What is the authorization header?

The authorization header contains the base64 encoded user credentials provided by the production integrations team.

Why is it important to utilize iCIMS standard field framework?

In order to create a repeatable and scalable integration iCIMS strongly suggests using our standard field framework to allow multi-tenancy.  All iCIMS standard fields have the same integration ID’s across all clients.

Does iCIMS support other languages such as HR-XML?

No.  iCIMS suggests conversion software to make the integration work with our JSON API.

How can I customize my organizations attributes for the mutual clients?

iCIMS standard list editor fields have the ability to add, delete, and rename drop-down options for al list editor fields.  This customization can be added by our production integrations team.

How can I manually test API calls?

iCIMS suggests using the Google Chrome Advanced REST Client plugin.  This client allows an easy to use API to test iCIMS inbound messaging.  

How do I make a call?

To make a call you must first make sure that you have communicated the IP addresses that you will be accessing the API with to your iCIMS associate.  iCIMS should then communicate back user credentials to allow inbound access to make calls.  These credentials can be added to the Google Chrome Advanced Rest Client plugin via basic authorization.  A sample call would look similar to the following:

https://api.icims.com/customers/1769/jobs/1707/?fields=bgcpackagetype

Please reference the specific integration page for more details.

How do I capture all posted Job details for a specific iCIMS client?

iCIMS provides a sitemap that exposes all posted job details.  This information can be captured from a client URL similar to (https://jobs-preview5test.icims.com/sitemap.xml)

Does iCIMS institute any rate limitations?

Yes.  See the Licenses page for information.

I cannot make patch calls using my HTTP library. Is there a workaround?

You can override the method using a GET argument or a header:

GET /resource?_method=POST

or

> POST /books
> X-HTTP-Method-Override : PATCH

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