Skip to main content

​
Implementation Overview

Implementation Type: Direct API Integration
Note Format: HTML
Status: Production Ready ERecruit is a direct API integration with full custom implementation of all required methods. This is one of our most mature and feature-complete integrations.

​
Configuration

PropertyValueDescription
Provider EnumerecruitIdentifier in ProviderEnum
Note FormatHTMLHTML-formatted notes
Disposition ReasonsSupportedCustom rejection reason implementation
All Application StagesSupportedFetches stages from ERecruit API
Base URLCustomer-specificEach org has unique API endpoint

​
Feature Coverage

Streaming Operations

​
Stream Jobs

Status: Supported (Custom Implementation)
Method: _stream_jobs(updated_after, statuses)Direct implementation streaming jobs from ERecruit’s Position API with pagination support.

​
Stream Applications

Status: Supported (Custom Implementation)
Method: _stream_applications(updated_after, for_job_ids)Streams applications using ERecruit’s Submission API with full filtering capabilities.

​
Stream Candidates

Status: Supported (Custom Implementation)
Method: _stream_candidates(updated_after)Streams candidate data from ERecruit’s Contact API with incremental updates.

​
Move Application to Stage

Status: Supported (Custom Implementation)
Method: _move_application_to_stage(application, stage)Moves submissions between workflow stages using ERecruit’s stage management API.

​
Get Disposition Reasons

Status: Supported (Custom Implementation)
Method: get_disposition_reasons()Retrieves rejection reasons from ERecruit’s workflow configuration.

​
Reject Application

Status: Supported (Custom Implementation)
Method: reject_application(application_id, reason_id)Rejects submissions with proper status updates in ERecruit.

​
Bulk Reject Applications

Status: Supported (Custom Implementation)
Method: bulk_reject_applications(application_ids, reason_id)Implements bulk rejection with proper error handling.

​
Create Application

Status: Supported (Custom Implementation)
Method: _create_application_for_candidate(candidate, job)Creates new submission records in ERecruit.

​
Get All Application Stages

Status: Supported (Custom Implementation)
Method: _get_all_application_stages()Fetches all available workflow stages from ERecruit.

​
Get Job by ID

Status: Supported (Custom Implementation)
Method: get_job_by_job_id(job_id)Direct lookup of positions in ERecruit.

​
Get Enhanced Job

Status: Supported (Custom Implementation)
Method: get_enhanced_job(kombo_id, remote_job_id)Fetches full position details including custom fields and metadata.

​
Fetch Enhanced Jobs Batch

Status: Supported (Custom Implementation)
Method: _fetch_enhanced_jobs_batch_from_ats(limit, cursor)Batch processing of position data with pagination.

​
Get Candidate by ID

Status: Supported (Custom Implementation)
Method: _get_candidate_by_id(candidate_id)Retrieves contact records from ERecruit API.

​
Find Candidates by Details

Status: Supported (Custom Implementation)
Method: _find_candidates_by_details(first_name, last_name, email, phone)Comprehensive candidate search with multiple criteria.

​
Get Resume

Status: Supported (Custom Implementation)
Method: _get_resume_for_candidate_id(candidate_id)Downloads resume documents from ERecruit’s document storage.

​
Add Note to Application

Status: Supported (Custom Implementation)
Method: _add_note_to_application(application, note, note_action_type)Adds notes to submission records with custom note action types.Implementation Notes:
Uses ERecruit’s TENZO_PRESCREEN_NOTE_ACTION_ID (496) for Tenzo-generated notes.

​
Add Note to Candidate

Status: Supported (Custom Implementation)
Method: _add_note_to_candidate(candidate, note, note_action_type)Adds notes directly to contact records.

​
Add Attachment to Application

Status: Supported (Custom Implementation)
Method: _add_attachment_to_application(filename, application_id, pdf_b64)Uploads documents to submission records.

​
Add Attachment to Candidate

Status: Supported (Custom Implementation)
Method: _add_attachment_to_candidate(filename, candidate_id, pdf_b64)Uploads documents to contact records.

​
Application Custom Fields

Status: Supported (Custom Implementation)
Methods:
  • _get_application_custom_fields() - Retrieves submission custom field definitions
  • _update_application_custom_fields(application, updates) - Updates submission custom fields
Full support for ERecruit’s custom detail fields on submissions.

​
Candidate Custom Fields

Status: Supported (Custom Implementation)
Methods:
  • _get_candidate_custom_fields() - Retrieves contact custom field definitions
  • _update_candidate_custom_fields(candidate, updates) - Updates contact custom fields
Full support for ERecruit’s custom detail fields on contacts.

​
Job Custom Fields

Status: Supported (Custom Implementation)
Methods:
  • _get_job_custom_fields() - Retrieves position custom field definitions
  • _get_job_custom_field_values(job_id) - Gets custom field values for positions
  • _update_job_custom_fields(job, updates) - Updates position custom fields
Comprehensive custom field support for positions.

​
Implementation Notes

​
Authentication

ERecruit uses OAuth2-based authentication with customer-specific API endpoints. Tokens are managed with automatic refresh 5 minutes before expiry.

​
Tagging System

The integration uses ERecruit’s tagging system:
  • TENZO_SCREENED_TAG_ID (65880): Applied to screened candidates
  • TENZO_SCREENED_STATUS_ID (101): Status for processed applications

​
Timezone Handling

ERecruit API returns times in local timezone. The integration handles this with a precautionary backfill window of 2 hours to prevent data loss.

​
Known Limitations

API Rate Limits
ERecruit APIs have rate limits. The integration includes throttling and retry logic to handle this gracefully.
Customer-Specific Configuration
Each ERecruit customer has unique API endpoints and custom field configurations. Setup requires customer-specific credential configuration.
  • Implementation: server/ats/erecruit_ats_client.py (~3,000 lines)
  • Field Mappings: server/ats/field_type_mapper.py (ERECRUIT_FIELD_MAPPINGS)
  • Base Class: server/ats/base_ats_client.py
  • Registration: server/ats/ats_factory.py

​
See Also