HR Provisioning

Dottie

In order for Fortytwo to connect to Dottie, we require a Client ID and Client secret configured under API access.

On this page

Required HR configuration

In order for Fortytwo to connect to the HR system, we require a Client ID and Client secret configured under API access, to access this API. Please provide this to your Fortytwo contact during the initial phase of implementation.

How to create Client ID and Secret in Dottie

  1. Go to Settings -> Integrations on this url

  2. Click "New API User".

    Select New API User
  3. Click "Create new".

  4. Take a note of "Client ID" and "API Key" and click "Close".

    Note down keys
  5. Now, Edit the user you just created. (You might need to refresh the browser to see it)

    Edit newly created user
  6. Add the role "Toppleder/Top Leader". and click "Close" and "Close".

    Add topleader role
  7. Done. Give the keys to your Fortytwo contact person.

Schema used for attribute mapping

The service sends each employee as a standard SCIM representation to the Entra ID Inbound Provisioning API. The below is a full example of the payload we send, and can be used to define attribute mapping in the customer tenant:

JSON
{
  "displayName": "Alma Nakken",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "department": null,
    "manager": {
      "value": "2"
    },
    "employeeNumber": "1",
    "organization": "Company Inc",
    "division": "HR"
  },
  "urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User": {
    "enddate": null,
    "jobtitleid": 17,
    "orglevel0id": "197",
    "orglevel0name": "Company Inc",
    "orglevel1id": "187",
    "orglevel1name": "HR",
    "orglevel2id": null,
    "orglevel2name": null,
    "orglevel3id": null,
    "orglevel3name": null,
    "orglevel4id": null,
    "orglevel4name": null,
    "orglevelids": [
      "197",
      "187"
    ],
    "raw": null,
    "ssn": null,
    "startdate": null
  },
  "name": {
    "familyName": "Nakken",
    "givenName": "Alma"
  },
  "phoneNumbers": [
    {
      "type": "mobile",
      "value": "+4799999999"
    }
  ],
  "externalid": "1",
  "active": true,
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
    "urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User"
  ],
  "title": "HR Consultant",
  "addresses": [
    {
      "primary": true,
      "type": "work",
      "region": "Oslo",
      "postalCode": "0862",
      "locality": "Oslo",
      "streetAddress": "Folke bernadottes vei 9A",
      "country": "NOR"
    }
  ]
}
SCIM attributeHR source objectHR source attribute
externalidEmployeeemployeeNumber
displayNameEmployeefirstname + lastname
titleEmployee, JobTitlejobTitleId used to look in JobTitle
name.familyNameEmployeelastname
name.givenNameEmployeefirstName
phoneNumbers[type eq "mobile"].valueEmployeePhonephoneNumber of kind 1
phoneNumbers[type eq "work"].valueEmployeePhonephoneNumber of kind 0
activeEmployeefirstDayOfWork, lastDayOfWork
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumberEmployeeemployeeNumber
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:managerEmployeeemployeeid of leaderId
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organizationEmployee, OrganizationUnitorganizationUnitId used to get level 1 of org structure
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:divisionEmployee, OrganizationUnitorganizationUnitId used to get level 2 of org structure
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departmentEmployee, OrganizationUnitorganizationUnitId used to get level 3 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:startdateEmployeefirstDayOfWork
urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:enddateEmployeelastDayOfWork
urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:ssnUserProfilenationalIdNumber
urn:ietf:params:scim:schemas:extension:fortytwo:1.0:User:jobtitleidEmployeejobTitleId
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel0nameEmployee, OrganizationUnitorganizationUnitId used to get level 1 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel1nameEmployee, OrganizationUnitorganizationUnitId used to get level 2 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel2nameEmployee, OrganizationUnitorganizationUnitId used to get level 3 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel3nameEmployee, OrganizationUnitorganizationUnitId used to get level 4 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel4nameEmployee, OrganizationUnitorganizationUnitId used to get level 5 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel0idEmployee, OrganizationUnitorganizationUnitId used to get level 1 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel1idEmployee, OrganizationUnitorganizationUnitId used to get level 2 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel2idEmployee, OrganizationUnitorganizationUnitId used to get level 3 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel3idEmployee, OrganizationUnitorganizationUnitId used to get level 4 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevel4idEmployee, OrganizationUnitorganizationUnitId used to get level 5 of org structure
urn:ietf:params:scim:schemas:extension:fortytwo:2.0:User:orglevelidsEmployee, OrganizationUnitorganizationUnitId used to get all ids from the org structure
Last updated 2 November 2026 Edit this page on GitHub
Esc