Business identities

A business identity is the record of a person's affiliation with your organization. An authority, such as an HR system or a student administration system, gives the record. The record says who the person is and how the person is affiliated with your organization.

A business identity is not a Microsoft Entra ID user. It exists without a Microsoft Entra ID user. Identity Stack links the business identity to the Microsoft Entra ID user of the person.

Contents of a business identity

Field	Required	Description
Source	Yes	The system that gives the business identity, for example the name of your HR system
External ID	Yes	The identifier of the record in the source system
Affiliation type	Yes	The type of affiliation. See Affiliation types.
First name	Yes
Last name	Yes
Birth date	No
Nationality	No	A two-letter country code (ISO 3166-1 alpha-2), for example DK
Personal email	No	A private email address, not the work address
Personal phone	No	A private phone number, not the work number
Personal numbers	No	National personal numbers. At this time, only the Danish CPR number. One number for each type.
Identity documents	No	References to passports and national ID cards: the type, the issuing country, and the document number
User	No	The Microsoft Entra ID user that the business identity is linked to

Affiliation types

Affiliation type	Description
Employment	The person works for your organization.
Enrollment	The person is enrolled at your organization, for example a student.
Engagement	The person is engaged by your organization, for example an external consultant.
Other	The affiliation is not one of the types above.

In the API, the values are EMPLOYMENT, ENROLLMENT, ENGAGEMENT, and OTHER.

Sources

Each business identity comes from one source. A source changes only its own business identities. Identity Stack supports these sources:

Source	How the business identities get to Identity Stack	Who can change them
An HR system or other source system	Your integration sends them to the Identity Stack API. See Custom integration.	Only the source system
Active Directory	Identity Stack Agent reads them from your directory. See Active Directory.	Only Active Directory
Manual	An administrator creates them in Identity Stack.	An administrator

Links to Microsoft Entra ID users

A business identity can be linked to one Microsoft Entra ID user. A Microsoft Entra ID user can be linked to one business identity.

• An integration links business identities in bulk. See Custom integration.
• Identity Stack links business identities from Active Directory automatically. See Active Directory.
• An administrator can link or unlink a business identity manually. This is possible for business identities from all sources.