2. Create your entity
An Entity in Heedify is the top-level organizational unit that owns agents, queues, flows and analytics, with four role types (Owner, Admin, Supervisor, Reports Viewer) gated by Microsoft 365 sign-in. You need at least one Entity before you can configure anything else.
A default entity named default is automatically created when you complete the Admin Portal consent in Step 1.
Steps
- Open Administrations from the sidebar.
- Click + Add New Entity.
- Enter the Entity name (3 characters minimum). The portal strips spaces automatically as you type —
MyEntityandMy Entityproduce the same name,MyEntity. - The user who creates the first entity is added to it automatically with the Owner role. Add any other administrators from the Add user button if needed.
- Click Save.
The entity name is the unique identifier of the entity. It cannot be changed after creation — the name input is locked once the entity exists. Choose a name you can live with long-term.
Tips
- If your organization has multiple business units, create one entity per unit — configurations stay isolated.
- The Owner role can never be removed implicitly: only another Owner can change ownership.
See Entities for the full reference.
Next → 3. Provision agents