Atlas ConnnectGuideReference

Creating your 1st employee

All requests related to this API is around employee data. To get started, first you will need one employee on the database. Method is POST and the path of url is:

community/api/v1/employee

Mandatory objects:

PersonalInfo, WorkLocation, EmploymentInfo, ExternalUserInfo

Optional Objects

emergencyContact, bankInfo, offboardingInfo, compensationDetails, payItems

So one good start for initial employee data might be

{
  "externalEmployeeId": "0000005",
  "resellerEmployerId": "ABCDEF-reseller",
  "personalInfo": {
    "firstName": "my first user",
    "lastName": "Atlas Connect",
    "preferredName": "AtlasConnect",
    "clientId": "f0fc3e97-afbf-4441-bfaf-377ad3580cdf",
    "titleCode": 1,
    "genderCode": 1,
    "birthday": "2005-04-03",
    "maritalStatusCode": 1,
    "homeAddress": {
      "addressLine1": "Av naro of flemming 456",
      "cityName": "Flamingo",
      "stateCode": "RS",
      "countryCode": "US",
      "postalCode": "1234657"
    },
    "isMultipleCitizenIndicator": false,
    "citizenship": [
      {
        "countryCode": "US",
        "nationalId_1": "98435465455"
      }
    ],
    "personalPronounCode": 1,
    "contactDetails": {
      "mobilePhone": {
        "countryCallingCode": "US",
        "number": "55519957810215"
      },
      "linkedinUrl": "https://linkedin.coim/hellow",
      "loginId": "employeemail@company.com"
    }
  },
  "workLocation": {
    "workLocationCode": 1,
    "addressLine1": "Central Perk",
    "cityName": "NY",
    "stateCode": "NY",
    "countryCode": "US",
    "postalCode": "151654",
    "isWorkSameAsHomeAddressIndicator": true
  },
  "employmentInfo": {
    "targetStartDate": "2025-01-01",
    "atlasStartDate": "2025-01-01",
    "seniorityDate": "2025-01-01",
    "jobTitle": "Sr of nothing",
    "divisionName": "IT",
    "employmentTypeCode": 1,
    "workingHrsPerWeek": 44,
    "employmentTermCode": 2,
    "termEndDate": "2026-04-03",
    "contractEndDate": "2026-04-03",
    "departmentName": "STW",
    "jobDescription": "Save the wordl",
    "isProbationApplicableIndicator": true,
    "probationPeriodTypeCode": 2,
    "probationPeriodQuantity": 12,
    "managerEmail": "manager@atlashxm.com"
  },
   "externalUserInfo": {
    "externalCreatedOn": "2025-01-01",
    "externalCreatedBy": "StarLord",
    "externalUpdatedOn": "2025-01-01",
    "externalUpdatedBy": "StarLord"
  }
}

follows a list with descriptions for every field