Connecting JobCannon to iCIMS
Setup guide for JobCannon assessments in iCIMS via the iCIMS Marketplace. Covers credential provisioning, enterprise configuration, and production deployment.
Connecting JobCannon to iCIMS
JobCannon integrates with iCIMS via the iCIMS Marketplace and iCIMS Connect API. iCIMS is an enterprise recruiting platform designed for large organizations. This guide covers credential provisioning, sandbox testing, and production deployment.
Quick Reference
| Property | Value ||----------|-------|| Auth method | OAuth 2.0 (enterprise) || API version | iCIMS Connect v1 || Protocol | HTTPS/JSON || Rate limit | 500 requests/minute (burst: 1000/min) || Sandbox available | Yes (iCloud staging) || Callback protocol | HTTPS POST (JSON) || Data residency | US or EU (configurable) || Retention default | 90 days (enterprise override) |Prerequisites
Step 1: Register in iCIMS Marketplace
1. **Navigate to iCIMS Marketplace:** https://www.icims.com/marketplace/
2. **Search for "JobCannon"**
3. **Click "Install"** on the JobCannon assessments app
4. **Review permissions:**
- Candidate profile read/write
- Assessment delivery
- Scorecard field updates
5. **Click "Authorize"** — iCIMS will redirect to OAuth flow
Step 2: Authorize OAuth Integration
During the marketplace install, iCIMS redirects to JobCannon's OAuth endpoint:
- `candidate_profile:read`
- `candidate_profile:write`
- `assessment_delivery:write`
- `scorecard:write`
Approve the scopes. JobCannon receives an access token valid for 2 years.
Step 3: Configure Assessment Triggers
Once authorized, configure how assessments are triggered:
1. **Log in to iCIMS**
2. **Go to Settings → Marketplace Apps → JobCannon**
3. **Click "Configuration"**
4. **Set trigger rules:**
- On candidate stage entry (auto-send)
- On recruiter action (manual)
- Custom workflows (advanced)
5. **Set assessment catalog** (Big Five, DISC, etc.)
6. **Configure email template** (branded or default)
7. **Save**
Step 4: Test in Staging (iCloud)
Before going live in production:
1. **Create a test candidate** in iCIMS staging (iCloud environment)
2. **Assign a job** and **advance to assessment stage**
3. **Trigger an assessment** (auto or manual)
4. **Candidate receives email** with assessment link
5. **Complete the assessment** in browser
6. **Verify callback:** Check JobCannon admin (/admin/integrations/icims/logs) for webhook delivery
7. **Check scorecard:** The candidate record should show assessment result
Common Errors
Error: "OAuth token expired"
**Cause:** Token is >2 years old or was revoked.
**Fix:**
1. Contact JobCannon support ([email protected])
2. Re-authorize in iCIMS Marketplace
3. Token will be refreshed and integration reactivated
Error: "Scorecard field not found"
**Cause:** Custom scorecard field was deleted or renamed in iCIMS.
**Fix:**
1. Verify scorecard field exists in iCIMS admin
2. Check field name matches JobCannon configuration
3. Create the field if it doesn't exist (custom scorecard fields must be pre-created in iCIMS)
Error: "Candidate profile write failed (403)"
**Cause:** OAuth scopes lack `candidate_profile:write` permission.
**Fix:**
1. Re-authorize the marketplace app
2. Approve `candidate_profile:write` scope
3. Retry the assessment delivery
Verification Checklist
Enterprise Configuration
For large organizations:
Contact JobCannon enterprise support for custom configuration: [email protected]
---
**Vendor docs:** https://www.icims.com/marketplace/
**Connect API:** https://www.icims.com/developers/api
**Support:** [email protected]