Configure and verify iCIMS event notifications for candidate workflow status-change events via the REST API

domain: recruiting · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. In the iCIMS platform's Event Notifications page, select the Workflow Status Update event and map it to the specific candidate status(es) that should trigger it
  2. Provide the receiving endpoint's HTTPS URL (a valid, non-self-signed SSL certificate is required) and choose the outbound authentication method: OAuth 2.0 client credentials, HMAC, or Basic Auth
  3. Build the endpoint to accept GZIP'd JSON POST payloads containing newStatus, oldStatus, customerId, jobId, userId, personId, systemId, links, and eventType
  4. Respond within 30 seconds with HTTP 200 (optionally including a JSON userMessage) for success, 303 See Other with a redirect Location if required, or 400 Bad Request for malformed input
  5. Configure or disable the 'Show Confirmation' setting depending on whether your endpoint supplies its own user-facing confirmation message
  6. Test by transitioning a candidate through the mapped status in a sandbox/test client and confirm the notification is delivered and acknowledged correctly

Known gotchas

Related routes

Configure and verify a SmartRecruiters webhook subscription for candidate pipeline/status-change events
recruiting · 6 steps · unrated
Subscribe to Workable v3 candidate stage-change webhook events and verify signatures
workable.readme.io · 5 steps · unrated
Authenticate to the iCIMS Applicant Tracking API with OAuth2 client credentials across US and EU data centers
developer.icims.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans