Skip to main content

Contract Groups: manage contracts across multiple entities

This article explains what Contract Groups are, how to set them up, and how to manage them effectively across multiple entities in your organization.

What are Contract Groups?

If your job board contract includes multiple entities, and has therefore multiple credentials, use the Contract Groups feature to ensure vacancies are promoted under the correct account on the job board. This feature allows you to bundle multiple job board contracts together and share them across different entities in your organization.

Why use Contract Groups?

Contract Groups help you manage all contracts in one central place: Acquisition > Contracts

  • Manage multiple entities: Easily handle job board contracts that involve different branches or subsidiaries within your organization.

  • Centralize your credentials: Bundle separate job board contracts together into a single, organized group for easier management.

How it works

  1. Create a Group: Go to Acquisition > Contracts and create a group with a clear name.

  2. Add Contracts: Add one or more job board contracts to that group with their respective credentials.

  3. Promote a job: Recruiters can then use those contracts when posting jobs for their entity.

⚠️ Important:

  • Make sure to click "+Add" on the group you wish to link your job offer to on the job board.

    • Example: When you add a contract from Tellent Branch 1 (e.g., France Travail or APEC), your job will be promoted under that specific branch's account.

  • You can only select one contract group per job promotion. Ensure your groups are organized based on which contracts need to be used together.

    • Example: Once a contract from Tellent Branch 1 is selected, all contracts assigned to Tellent Branch 2 will become unavailable for that job promotion.

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. 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.

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.

📌 Note: The Default Group will only appear once you have configured two or more contracts for the same job board channel.

See example below:

  • The Default Group is not appearing because the APEC contract has only been configured once:

  • The Default Group now appears after configuring a second APEC contract:

Set up a Contract Group

There are multiple ways to create a Contract Group, depending on how the job board is integrated. Once set up, the contracts in your group will be available to recruiters when posting jobs for the assigned entities.

📌 Note:

  • The Groups section only appears once you have configured two or more contracts for the same job board channel. If you only have one contract, the Groups section will remain hidden when configuring your new contract:

  • If you skip naming a group when configuring a job board contract, it will be added to the Default group.

Method 1: XML Feed-based connections

💡 The following job boards are integrated via XML feed:

  • Jobs.ch, Jobup.ch, Meteojob, Cadremploi, Karriere.at, Willhaben.at, Meinestadt.de, Stellenanzeigen.de.

1. Create a new Contract Group

Go to Acquisition > Contracts, then:

  1. Select the job board contract you want to include in the group

  2. Click Configure Contract

  3. Copy the XML feed URL (save it in your notes)

  4. Open the Group modal and scroll to Add New Group

  5. Give your group a clear, descriptive name (e.g., "Acme Hiring" and "Atlas Hiring") and click Create Group

  6. Add your credentials, paste the XML feed URL in the Confirmed XML feed URL field and click Add to my contracts

  7. Share your XML feed URL with your job board contact to get it indexed

2. Assign a job board contract to an existing Contract Group

  1. To add more contracts to the group, repeat steps 1–3 for each additional contract that is integrated via XML

  2. Assign the job board contract to an existing Contract Group

  3. Add your credentials, paste the XML feed URL in the Confirmed XML feed URL field and click Add to my contracts

  4. Share your XML feed URL with your job board contact to get it indexed

Method 2: API connections

💡 The following job boards are integrated via API:

  • APEC, Stepstone Liquid Design, France Travail, VDAB, LeBonCoin, Werkzoeken, HotelCareer, HotelProfessionals, Werk.nl, AMS.at, JobTeaser.

1. Create a new Contract Group

Go to Acquisition > Contracts, then:

  1. Select the job board contract you want to include in the group

  2. Click Configure Contract

  3. Open the Group modal and scroll to Add New Group

  4. Give your group a clear, descriptive name (e.g., "Acme Hiring" and "Atlas Hiring") and click Create Group

  5. Add your credentials and click Add to my contracts

2. Assign a job board contract to an existing Contract Group

  1. To add more contracts to the group, repeat steps 1–2 for each additional contract that is integrated via API

  2. Assign the job board contract to an existing Contract Group

  3. Add your credentials and click Add to my contracts

Method 3: Authenticated Connections

💡 The following job boards are integrated via API and require you to log in to your account to complete the connection:

  • LinkedIn, XING, Indeed Sponsored Jobs.

1. Create a new Contract Group

Go to Acquisition > Contracts, then:

  1. Select the job board contract you want to include in the group

  2. Click Configure Contract

  3. Click Continue on the Instructions page

  4. Click Initialize authentication and configure your account

  5. Click again Continue on the Instructions page

  6. Open the Group modal and scroll to Add New Group

  7. Give your group a clear, descriptive name (e.g., "Acme Hiring" and "Atlas Hiring") and click Create Group

  8. Add your credentials and click Add to my contracts.

2. Assign a job board contract to an existing Contract Group

  1. To add more contracts to the group, repeat steps 1–5 for each additional contract that require you to login (=initialize authentication)

  2. Assign the job board contract to an existing Contract Group

  3. Add your credentials and click Add to my contracts

Managing your Contract Groups

Once your groups are created, you can update them at any time from Acquisition > Contracts:

Add a job board contract

Select the contract and assign it to an existing group. See instructions above.

Remove a job board contract

Click Remove contract next to the relevant contract within the group.

Rename a group

1. Click on the group name that you want to edit and click Rename group

2. Then, give it a name and click Update group

Remove a group

1. Click on the group name that you want to remove and click Remove group

2. Then, click Remove group again on the confirmation modal. You must delete the active contracts in this group before deleting the group.

Best practices

  1. Keep it structured: Group contracts by how your teams work, for example, by entities, region, or department.

  2. 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.

  3. 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, XING and Stepstone Germany, and assign it to the entity Atlas.

Did this answer your question?