Agency Portal Settings Guide - Initial setup
Last updated: November 2, 2026
The Agency Portal Settings define how agencies work with you. These settings should be configured as part of the initial setup before inviting agencies.
In this section, you control key behaviors such as default language and currency, duplicate candidate prevention, agency recruiter permissions, communication preferences and role-based access. Configuring these options upfront helps ensure clear ownership, smooth collaboration, and proper alignment with your Recruitee workflows.
This article provides an overview of each setting and explains how it impacts agency activity across the platform.
In this article:
Accessing the Agency Portal Settings
Basic portal settings
Duplicate candidate prevention
Credit system & busy spots
Agency Recruiter Permissions
Chat & communication
Screening questions
Advanced settings
Default stage mappings
Permissions
Support
Accessing the Agency Portal Settings
You can find the Agency Portal Settings by navigating to:
AgencyHub (left side bar) → Agency Portal Settings.
Basic Portal Settings

Configure fundamental options including:
Default language for agency hiring activities
Default currency for agency transactions
Duplicate Candidate Prevention

Prevention Level
Prevent agencies from introducing a previously introduced candidate (identified by email, phone, or LinkedIn) more than once. Choose:
None – no duplicate checking
Current job – block a candidate from being introduced twice for the same job only (agencies can still propose the same candidate to a different job)
All jobs – block a candidate from being introduced more than once across any job
Look Back Period
How far back in time to check for duplicates. For example, setting this to 12 months means only duplicates introduced within the last year are blocked.
Which Candidate Stages to Check
Select which Recruitee stages to check for duplicates. Leave this empty to check all stages.
Check Recruitee for Existing Candidates
When enabled, the system also searches Recruitee for an existing candidate or application with the same email address at the moment a candidate is introduced.
Note: Also email aliases such as candidate+1@email.com will be recognized as a duplicate if candidate@email.com has already been introduced/is already in the system.
Credit System

The credit system limits the amount of candidates that an agency user can propose to a job. The intention is to let them select only the best suited candidates.
For every candidate that is moved in Recruitee to interviews, a new credit is awarded to the agency user.
Busy spots helps you let agency recruiters focus on roles that need the most attention instead of proposing candidate to jobs with already properly filled candidate pipelines.
Agency Recruiter Permissions

Candidate Movement Control
Decide whether agency recruiters can move candidates through stages themselves, or can only view stage changes you make (shown as View Only by default).
Allow Marking Candidates as Hired
Let agency recruiters mark their own candidates as hired. When this is disabled, only your team can mark candidates as hired.
Allow Withdrawing and Rejecting Candidates
Let agency recruiters withdraw their own candidates. This will show as a note on the candidate profile.
Fee Approvals

Fee Approvals adds an extra control step for the recruitment fee before it reaches the agency. The fee is pulled from the contract and must be approved before it's sent to the agency as the approved fee.
⚠This is not invoicing — invoicing itself is outside the scope of the Agency Hub.
Control who on your team can manage fee approvals and who gets notified about them.
Fee Approvals
This toggle turns the entire fee approval page and feature on or off. When turned off, the fee approval page is hidden from your team, existing fee approval records stay saved, and new hires will no longer create fee approvals.
Fee Approvers
Choose which team members can approve the fee on new hires and access the fee approval page. Company admins always have this access by default.
Fee Approval Notification Recipients
Select which users receive system chat messages and notifications related to fee approvals. If no users are selected, notifications are sent to all admins.
Chat & Communication

Email notifications are controlled in two places. Users only receive emails if notifications are also enabled for their role in the Permissions tab.
All Agency Hiring Email Notifications
Master switch that enables or disables all email notifications related to agency hiring across your organization. Users still only receive emails if their role also allows email notifications in the Permissions tab.
Email Notification Recipients for Candidate Related Chat Messages
Control who receives email notifications for candidate-related chat messages:
Disabled
Hiring Team
Specific Users
Specific Hiring Team roles
Hide Individual Agency Recruiter Names
When enabled, chat shows only the agency name instead of the individual agency recruiter's name, so your team won't see who specifically is working on the candidate.
Hide System Messages
When enabled, automated system messages (such as star ratings and stage changes) are hidden from the chat view, so only user-written messages are shown.
Restrict Agency Inbox Chats to the Hiring Team
When enabled, your users only see candidate chats and job chats for jobs where they're on the hiring team.

Chat Access for Hiring Team Roles
Limit chat access to hiring team members with specific roles. Leave this empty to give access to all roles.
Notes on New Messages
Choose whether HirePort automatically creates a note whenever a new message is received.
Who Can See Notes
Choose the visibility for notes that the Agency Hub adds. Always Public means everyone in your company can see them. Always Private lets you restrict visibility to specific people, since notes may contain sensitive information.
Create Salary & Benefits Note on Introduction
When enabled, HirePort automatically creates a note with salary and benefits information whenever an agency introduces a candidate. This note is visible to all Recruitee users who have access to the candidate profile.
Choose Who Can See this note
When notes are set to private, use this setting to specify exactly which team members can see them. You can assign access by individual Users or by Roles. Anyone not listed here won't see the notes at all.
Screening Questions

Enabling ATS Screening Questions lets agencies answer the same screening questions that candidates would normally fill in when applying directly. These questions appear when an agency proposes a candidate, and they're also visible in HirePort at the bottom of the job page.
You can also create custom screening questions specifically for agency submissions, in addition to the standard ATS ones. These custom questions can be scoped to a specific employment type, asked as different question types, and placed in one of two spots: on the introduction page (where they can be made required) or later in the agency chat (where they're optional).
Advanced Settings

Candidate Name Suffix
Add text after candidate names in Recruitee to identify them (for example, "John Doe (Agency)"). Leave this empty if you don't need it.
Candidate Consent
When enabled, HirePort sends candidate consent to Recruitee at the time a candidate is introduced. Take over Recruitee consent duration or set custom.
Candidate Tags in ATS
Choose what information to add as tags in Recruitee:
All Tags (Include Fee) – agency name, company name, and recruitment fee
No Fee Tag – hides fee information from Recruitee
No Tags
Hide Rejection Reason from Agencies
When enabled, the rejection reason is not stored or shared with recruiting agencies. They'll only see that a candidate was rejected, not the specific reason.

Hide Hiring Team
When enabled, hiring team information is hidden on jobs.
Candidate Source Label
If you prefer a uniform source label for agency candidates (instead of using the agency name), you can define it here.
⚠ Ensure this label does not conflict with other sourcing channels (e.g., career site, social media).
Default Stage Mappings

Default Stage Mappings actually control two things: which of your Recruitee stages are visible to agencies, and which stages trigger automated email notifications to agencies as a candidate is moved through them in Recruitee. Each stage can be assigned to a standard stage type, hidden from agency view entirely, or auto-mapped with AI.
⚠ A job's first mapped interview stage in this section determines where the agency candidate is created in Recruitee.
To configure your stage mappings:
Click Sync stages from Recruitee to pull in your latest stages, or click Auto-map stages (AI) to have HirePort suggest mappings automatically.
For each substage, choose a stage type from the dropdown (for example, Introduced), or turn on Hide for Agencies to keep an internal-only stage invisible to agencies.
Drag a stage to reorder it into the right position.
Use the search box, or the Unmapped and mapped-stage groups, to find a stage quickly. Select multiple stages with the checkboxes and use Apply to selected to map them all at once.
Click Save Mappings when you're done, or Discard changes / Reset to undo your edits.
⚠ If your default stage mappings are not configured correctly, this will cause synchronization issues to the agency side of the portal.
Permissions

⚠ Chat & Communication and Fee Approvals each have additional settings that control who can see what in the Advanced Agency Portal. Some of these can be set at the Hiring Team role level, but the permissions listed below are based on system roles.
Set role-based access across HirePort features.
Use the Role dropdown to select a system role from Recruitee.
Configure the permissions below for that role:
Master Contracts
None – no visibility
View – read-only access
Manage – full access to create, view, edit, and delete
Agencies
None – no visibility
Assign – view and assign agencies to jobs
Manage – full administration
Chat with Agency
Toggle to set whether users with this role can communicate with agencies.
Email Notifications for This Role
Controls whether users with this role can receive agency hiring related email notifications, including chat messages and candidate updates. This applies to all users assigned to this role, provided email notifications are also enabled in the Chat & Communication settings.
Need help?
Contact Recruitee support.