What are Contract Groups?
Contract Groups let you bundle multiple job board contracts together and share them across different entities in your organization. Instead of managing contracts one by one, you can group them, name them, and make them available to the right teams.
Before you begin
⚠️ Important: Each entity requires its own job posting. The same job cannot be shared or posted across multiple entities. Plan your Contract Groups accordingly.
Why use Contract Groups?
Contract Groups help you manage all contracts in one central place: Acquisition > Contracts
Use the same contracts across multiple entities
Give recruiters clear, organized access to only the contracts they need
Scale more easily as your organization grows
How it works
Create a Contract Group and give it a clear name
Add one or more job board contracts to it
Assign it to the relevant entities in your organization
Recruiters can then use those contracts when posting jobs for their entity
Understanding the Active Contracts page
When you navigate to Acquisition > Contracts, you can see your contracts and organize them into groups under Active Contracts. Each group displays the job board contracts assigned to it.
You'll notice a Default group at the top. These contracts aren't assigned to a specific group. As you create and organize your Contract Groups, you can move contracts out of Default and into the appropriate group.
💡 Tip: Your groups will appear exactly as you name them on this page. Clear, consistent names make it easy for recruiters to find the right contracts at a glance.
Set up a Contract Group
There are two ways to create a Contract Group, depending on how your job board is integrated: via an XML feed or via an API.
Method 1: XML feed & manual Job Board Contracts
Go to Acquisition > Contracts, then:
Select the job board contract you want to include in the group
Click Configure Contract
Add your Credentials and Group
Give your group a clear, descriptive name (e.g., "Acme Hiring" and "Atlas Hiring")
To add more contracts to the group, repeat steps 1–3 for each additional contract
Assign the group to the Contract
Click Add to my contracts
💡 Tip: If you skip naming the group when configuring the job board contract, it will be added to the Default group.
Method 2: API Authentication Job Board Contracts
Go to Acquisition > Contracts, then:
Click Configure Contract and continue
Click Initialize authentication and configure your account
Then, when on the Instructions page, click continue
Add the company ID
Give your group a clear, descriptive name (e.g., "Acme Hiring" and "Atlas Hiring")
Assign the Contract to the relevant group.
Click Add to my contracts
Once set up, the contracts in your group will be available to recruiters when posting jobs for the assigned entities.
Managing your Contract Groups
Once your groups are created, you can update them at any time from Acquisition > Contracts:
Add a contract: Select the contract and assign it to an existing group
Remove a contract: Click Remove contract next to the relevant contract within the group
Rename a group: Click on the group name to edit it
Option 1: XML Job Board Contract Group
Option 2: API Job Board Contract Group
Best practices
Keep it structured: Group contracts by how your teams work, for example, by brand, region, or department.
Name groups clearly: Your groups appear exactly as named on the Active Contracts page, so make sure recruiters can identify the right one at a glance.
Only assign where needed: Limiting access helps prevent confusion or misuse.
Avoid large groups: Smaller, focused groups are easier to manage and maintain over time.
Review regularly: Periodically check your groups to make sure all contracts remain valid and relevant.
Example
Your organization is hiring across two entities: Branch 1 and Branch 2. Here's how you might set this up:
Create a Contract Group called "Branch 1 (Acme Hiring)" with contracts for LinkedIn, Werk.nl, and assign it to the entity Acme.
Create a Contract Group called "Branch 2 (Atlas Hiring)" with contracts for LinkedIn and Meinestadt.de, and assign it to the entity Atlas.
Recruiters in each entity will only see the contracts relevant to them when posting jobs
⚠️ Important: It is not possible to select different contract groups when promoting a job. Recruiters must create and manage jobs separately for each entity.