> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Organisations

> External entities, schools, corporates, suppliers, linked to profiles via Roles.

Organisations in Omneo represent external entities that are linked to customer profiles. They are used for B2B, corporate, school, or employer scenarios where a group identity is relevant to the customer relationship.

## What organisations represent

Common organisation types:

* **Corporate accounts**: a business whose employees are linked profiles
* **Schools**: students linked to their school for education-sector programs
* **Suppliers**: vendors whose staff receive brand discounts
* **Clubs or associations**: members of a group linked to the group entity

## Organisation fields

| Field         | Description                 |
| ------------- | --------------------------- |
| `name`        | Organisation display name   |
| `handle`      | Machine-readable identifier |
| `external_id` | ID in an external system    |
| `type`        | Organisation type/category  |
| `email`       | Organisation contact email  |
| `address`     | Organisation address        |

## Profiles and organisations

Profiles are linked to organisations via **Roles**. A role defines the nature of the relationship between a profile and an organisation (e.g., "Employee", "Student", "Member").

A single profile can be linked to multiple organisations with different roles.

## Use cases

* **Staff discounts for corporate partners**: link employee profiles to their employer and apply a staff benefit when the organisation is verified
* **School-based programs**: students linked to their school earn points or benefits for the school's program
* **Supplier staff access**: supplier employees with a verified organisation link get access to trade pricing benefits

## Related

* [Roles and permissions](/concepts/organisations/roles-and-permissions)
* [Organisation API](/api-reference/organisation)
* [Organisation profile API](/api-reference/organisation-profile)
* [Profiles](/concepts/profiles/overview)