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

  1. Open Administrations from the sidebar.
  2. Click + Add New Entity.
  3. Enter the Entity name (3 characters minimum). The portal strips spaces automatically as you type — MyEntity and My Entity produce the same name, MyEntity.
  4. 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.
  5. 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