Company subsidiaries

A subsidiary is a company listed under a parent company. Use subsidiaries when one organization has several parts that hire under their own names, such as regional sections, brands or divisions. Each part keeps its own public profile, page and jobs, and your Companies list shows the whole group together.

For example, a national organization can be the parent, with its western and eastern sections as subsidiaries. Candidates see each section's own page and jobs, and you see the family in one place.

Before you begin

Decide which company is the parent. Groups are one level deep, so the parent cannot itself be a subsidiary, and a company that already has subsidiaries cannot be moved under another company. You need access to the board's Companies area.

Add a subsidiary

You can move a company that is already on your board under a parent, or create a new company as a subsidiary.

Move an existing company under a parent

1. Click Companies in the sidebar
2. Click the menu at the end of the company's row
3. Click Make subsidiary…
4. Search for the parent, pick it and click Make subsidiary

Once a parent has a subsidiary, you can also add companies from the parent: open the parent, click Add subsidiary in the Subsidiaries section and pick the company. The picker lists standalone companies, since a company that has subsidiaries can't become one. The same window sets a routing rule for the parent's feed jobs, which you can leave empty.

The company keeps its profile, page and jobs.

Create a new subsidiary

1. Click Companies in the sidebar
2. Click the parent company to open it
3. In the Subsidiaries section, click Add subsidiary, then pick Create new company… in the company picker. The form opens with the parent picked.
4. Fill in the name and website
5. Click Add company

If the parent has no subsidiaries yet, click Add company in the companies list and enter a website on the parent's domain. When you leave Website, the form shows which company already uses that domain. Click Add as a subsidiary instead, and the form becomes a subsidiary of that company, keeping what you typed. A domain that belongs to a subsidiary can't be shared, so the form shows that the domain is in use.

The Subsidiaries section appears on a company once it has at least one subsidiary.

What a subsidiary keeps

A subsidiary is a full company on your board:

• its own profile, public page and URL;
• its own jobs, which you post and manage exactly as on any other company;
• its own employer team, if you invite one.

Job counts in the Companies list count each company's own jobs.

Website and profile details

A subsidiary can use its own domain (westsection.example), its parent's domain (example.org), or a page on its parent's site (https://www.example.org/west/).

When a subsidiary has its own domain, Cavuno enriches its profile as it does for any company: logo, summary, description and social links.

When a subsidiary shares its parent's domain, Cavuno leaves its summary and description for you to write, so the subsidiary never gets a copy of its parent's profile. Write a summary and description that describe this part of the organization.

A subsidiary on its parent's domain also shares the parent's backfill feed. When it joins the group, or when the parent takes its domain, its backfill moves to the parent, so the feed's jobs land on the parent. To send them to the subsidiary, add a routing rule on the parent. A subsidiary with its own domain keeps its own backfill.

Logo

A subsidiary without a logo of its own shows its parent's logo, on its page and on its jobs. To give it its own, upload a logo in its profile. Remove that logo to show the parent's again. Changing the parent's logo also changes what its subsidiaries without a logo show.

Find a group in the companies list

The Companies list shows parents and standalone companies. Click the arrow next to a parent to show its subsidiaries. Sorting, filters and paging work on whole families, so a family never splits across pages.

A search that matches a subsidiary shows it under its parent. The parent appears dimmed when it doesn't match the search itself. Click Show all to see the rest of the family.

Move or remove a subsidiary

To remove a company from its group:

1. Click Companies in the sidebar
2. Expand the parent, then click the menu at the end of the subsidiary's row
3. Click Remove from parent

You can also click Remove from parent in the menu on the subsidiary's row in the parent's Subsidiaries section. Removing a subsidiary deletes its routing rule.

The company becomes standalone. Its profile, page and jobs stay as they are. If it showed its parent's logo, it shows no logo until you upload one.

A standalone company needs a website domain of its own. If the subsidiary uses its parent's domain or a page on its parent's site, open it, change Website to its own domain or clear it, and choose None in Parent company in the same save.

To move a subsidiary to a different parent, open it and pick the new parent in Parent company. Parent company appears only on a subsidiary's profile.

Deleting a parent company makes its subsidiaries standalone companies. Deleting a banned or excluded parent keeps it banned or excluded, even when a subsidiary uses its domain.

Set up groups through the API or an agent

Every step above is available through the Operator API, so an agent connected through the Cavuno MCP server can set up groups too.

• Company reads (GET /v1/companies/{id}) include parentCompanyId, which is null for a standalone company or a parent.
• GET /v1/companies?parentCompanyId={id} lists a parent's subsidiaries.
• POST /v1/companies with parentCompanyId creates a subsidiary.
• PATCH /v1/companies/{id} with parentCompanyId moves a company under a parent, and "parentCompanyId": null removes it from its group.

Requests that break the group rules return 422:

• company_group_depth when the parent is itself a subsidiary, the company already has subsidiaries, or the parent is the company itself;
• company_group_account when the parent belongs to another board.

409 companies_duplicate_domain applies as for any company, except when the website's domain belongs to the subsidiary's own parent. Removing a subsidiary on its parent's domain from its group returns 409 unless the same request sets a website of its own.

For example, an agent asked to put a regional section under its national organization can find both with GET /v1/companies?search=, then send PATCH /v1/companies/{sectionId} with { "parentCompanyId": "{parentId}" }.

Verify the result

Open Companies and expand the parent: the subsidiary is listed under it. Open the subsidiary's public page and confirm it shows its own name, the logo you expect, and its own jobs.