Skip to main content

Organization Hierarchy

First Dollar supports multi-level organizational structures through Organization Groups and Divisions. These concepts let you model real-world corporate hierarchies in the platform.

Concepts

ConceptDefinition
Organization GroupAn administrative container that groups related Organizations under one umbrella (for example, a holding company).
OrganizationAn employer group. Organizations can belong to a Group and can contain Divisions.
DivisionA subdivision of an Organization — a department, office, or business unit with its own benefit packages, members, and bank accounts.

How they relate

Organization Group (e.g., "Acme Holdings")
├── Organization A (e.g., "Acme East")
│ ├── Division 1 (e.g., "Sales")
│ └── Division 2 (e.g., "Engineering")
└── Organization B (e.g., "Acme West")
└── Division 3 (e.g., "Operations")
  • An Organization Group contains zero or more Organizations (one-to-many).
  • An Organization contains zero or more Divisions (one-to-many).
  • A Division belongs to exactly one parent Organization.
  • Divisions can nest under other Divisions for deeper hierarchies.

Guides

  • Organization Groups — Create and manage Organization Groups through the Partner API.
  • Organizations — Create and manage Organizations through the Partner API.
  • Divisions — Create and manage Divisions within an Organization through the Partner API.