{"info":{"_postman_id":"45cf8441-14c4-48a9-b286-fe332cfdfdf6","name":"Twiser User Integration Document","description":"

Welcome to the official API documentation prepared for user integration of our Twiser Wokr and Twiser LXP products. This documentation details all the endpoints, parameters, and authorization processes that allow you to establish seamless user management and data exchange (e.g., user creation, update, and access to relevant data) between your external systems and the Twiser platforms. You can quickly access the documentation for the relevant product from the menu on the left. You will find all the necessary information here to complete your integration quickly and securely.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"27134951","collectionId":"45cf8441-14c4-48a9-b286-fe332cfdfdf6","publishedId":"2sB2qcD1yv","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-07-01T11:10:39.000Z"},"item":[{"name":"Wokr User Integration Document V2.1","item":[{"name":"Login","item":[{"name":"Login","id":"ab3f990d-adea-4b6d-84fa-b8a99fe750c3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Email\": \"{{integrationMail}}\",\n \"Password\": \"{{integrationPassword}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{baseUrl}}/identity/api/auth/login","description":"

Request Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`Email`	string	The e-mail information used in the authorization process.
`Password`	string	The password information used in the authorization process.

Response Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description
`UserId`	UserID is the unique information of the user created in Twiser.
`CompanyId`	It is the company identification number to which the user is affiliated. It can be obtained from Wokr Admin User Interface.
`IsFirstLogin`	It’s the indication of whether it is the first login. It has to be `false`.
`LoginProvider`	Login provider information.
`AccessTokenExpiryTime`	Token expiration time.
`AccessToken`	An access token is required to call any other APIs. It needs to be passed through as in the request header.
`RefreshTokenExpiryTime`	Renewed token expiry time.
`RefreshToken`	Refresh token used to obtain a new access token after expiration.
`Message`	Message status.

","urlObject":{"protocol":"https","path":["identity","api","auth","login"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"2883723a-a3e6-457f-8f5a-5637711740d8","name":"Login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Email\": \"integration@integration.com\",\n \"Password\": \"Abc123!+\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.twiser.com/identity/api/auth/login"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"UserId\": \"a3dc14c7-9f3e-4d87-89a1-09a62b142ff2\",\n \"CompanyId\": 1,\n \"IsFirstLogin\": true,\n \"LoginProvider\": \"Twiser\",\n \"AccessTokenExpiryTime\": \"2023-06-15T14:32:19.8935482Z\",\n \"AccessToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6ImFkbWluQHR3aXNlci5jb20yb2xlIjpbIlN1cGVyQWRtaW4iLCJJbnRlZ3JhdGlvbkFkbWluIl0sIm5iZiI6MTY0MDI1ODY4NCwiZXhwIjoxNjQwMzgwMjg0LCJpYXQiOjE2NDAyNTg2ODQsImlzcyI6Imh0dHBzOi8vbG9jYWxob3N0OjUwMTEiLCJhdWQiOiJodHRwczovL2xvY2FsaG9zdDo1MDAxIn0.Q0nfcvFKeCCCyZGInlgbw-m_dmiyk_OOey6Yg43zuqM\",\n \"RefreshTokenExpiryTime\": \"2023-07-01T14:32:19.8935482Z\",\n \"RefreshToken\": \"7f8e04d67e7a132ee0c9f7a2a1a238a7\",\n \"Message\": \"Success\"\n}"}],"_postman_id":"ab3f990d-adea-4b6d-84fa-b8a99fe750c3"}],"id":"aef98082-ad4b-45de-a031-11416cba1006","_postman_id":"aef98082-ad4b-45de-a031-11416cba1006","description":""},{"name":"User","item":[{"name":"Get User List","id":"52c35e4b-7504-41b1-bbf4-c1a4e4b35b42","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{baseUrl}}/identity/api/application-user/get-user-list?companyId=0","description":"

Response Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`Id`	string	Unique identifier of the user (UUID format).
`CompanyId`	integer	ID of the company to which the user is affiliated.
`OrganizationLevelId`	string	ID of the organization level the user belongs to (nullable).
`OrganizationLevelText`	string	Display name of the organization level (nullable).
`IsManager`	boolean	Indicates whether the user is a manager.
`ParentId`	string	ID of the manager or parent user in hierarchy (nullable).
`FirstName`	string	User's first name.
`LastName`	string	User's last name.
`DepartmentId`	string	ID of the department the user is assigned to.
`Department`	string	Name of the department.
`ImageUrl`	string	URL to the user's profile image (nullable).
`Position`	string	User's job title or position.
`Email`	string	User's email address.
`BusinessUnit`	string	Business unit the user is affiliated with (nullable).
`EmployeeId`	string	Internal employee ID (nullable).
`HireDate`	string	Date the user was hired (ISO 8601 format).
`IsPerformanceIncluded`	boolean	Indicates whether the user is included in performance evaluations.
`MatrixManagerId`	string	ID of the matrix manager if applicable (nullable).
`IsLeft`	boolean	Indicates whether the user has left the company.
`IsDeleted`	boolean	Indicates whether the user is marked as deleted in the system.
`IsActive`	boolean	Indicates whether the user is currently active.
`Country`	string	Country code where the user is located (e.g., \"TR\").
`Gender`	string	User's gender (\"X\", \"M\", or \"F\").
`IsWhiteCollar`	boolean	Indicates whether the user is a white-collar employee.
`IsTopManagement`	boolean	Indicates whether the user is part of top management.
`Location`	string	Location of the user (city or site).
`FullName`	string	Full name of the user (concatenated first and last name).

","urlObject":{"protocol":"https","path":["identity","api","application-user","get-user-list"],"host":["{{baseUrl}}"],"query":[{"key":"companyId","value":"0"}],"variable":[]}},"response":[{"id":"f75d46d1-cb0d-43ed-b39b-2d293be3964e","name":"Get User List","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"}],"url":{"raw":"api-demo.twiser.com/identity/api/application-user/get-user-list?companyId=360","host":["api-demo","twiser","com"],"path":["identity","api","application-user","get-user-list"],"query":[{"key":"companyId","value":"360"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"Id\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"CompanyId\": 360,\n \"OrganizationLevelId\": null,\n \"OrganizationLevelText\": null,\n \"IsManager\": false,\n \"ParentId\": null,\n \"FirstName\": \"Deanna\",\n \"LastName\": \"Bayer\",\n \"DepartmentId\": null,\n \"Department\": \"Optimization\",\n \"ImageUrl\": null,\n \"Position\": \"Global Security Analyst\",\n \"Email\": \"DeannaBayer@google.com\",\n \"BusinessUnit\": null,\n \"EmployeeId\": null,\n \"HireDate\": \"2022-10-10T00:00:00\",\n \"IsPerformanceIncluded\": true,\n \"MatrixManagerId\": null,\n \"IsLeft\": false,\n \"IsDeleted\": false,\n \"IsActive\": true,\n \"Country\": \"TR\",\n \"Gender\": \"X\",\n \"IsWhiteCollar\": true,\n \"IsTopManagement\": false,\n \"Location\": \"East Jadonport\",\n \"FullName\": \"Deanna Bayer\"\n },\n {\n \"Id\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"CompanyId\": 360,\n \"OrganizationLevelId\": null,\n \"OrganizationLevelText\": null,\n \"IsManager\": false,\n \"ParentId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"FirstName\": \"Enos\",\n \"LastName\": \"Reynolds\",\n \"DepartmentId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"Department\": \"Quality\",\n \"ImageUrl\": null,\n \"Position\": \"Internal Configuration Representative\",\n \"Email\": \"EnosReynolds@google.com\",\n \"BusinessUnit\": null,\n \"EmployeeId\": null,\n \"HireDate\": \"2022-10-10T00:00:00\",\n \"IsPerformanceIncluded\": true,\n \"MatrixManagerId\": null,\n \"IsLeft\": false,\n \"IsDeleted\": false,\n \"IsActive\": true,\n \"Country\": \"TR\",\n \"Gender\": \"X\",\n \"IsWhiteCollar\": true,\n \"IsTopManagement\": false,\n \"Location\": \"Ellisfort\",\n \"FullName\": \"Enos Reynolds\"\n },\n {\n \"Id\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"CompanyId\": 360,\n \"OrganizationLevelId\": null,\n \"OrganizationLevelText\": null,\n \"IsManager\": false,\n \"ParentId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"FirstName\": \"Uriah\",\n \"LastName\": \"Reichel\",\n \"DepartmentId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"Department\": \"Optimization\",\n \"ImageUrl\": null,\n \"Position\": \"Customer Communications Associate\",\n \"Email\": \"UriahReichel@google.com\",\n \"BusinessUnit\": null,\n \"EmployeeId\": null,\n \"HireDate\": \"2022-10-10T00:00:00\",\n \"IsPerformanceIncluded\": true,\n \"MatrixManagerId\": null,\n \"IsLeft\": false,\n \"IsDeleted\": false,\n \"IsActive\": true,\n \"Country\": \"TR\",\n \"Gender\": \"X\",\n \"IsWhiteCollar\": true,\n \"IsTopManagement\": false,\n \"Location\": \"West Geraldmouth\",\n \"FullName\": \"Uriah Reichel\"\n }\n]"}],"_postman_id":"52c35e4b-7504-41b1-bbf4-c1a4e4b35b42"},{"name":"User Create","id":"1fb7e91f-629f-41a0-a1c6-cc959075f2e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"TenantId\": 0,\n \"CompanyId\": 0,\n \"Email\": \"string\",\n \"ParentId\": \"string\",\n \"ParentEmail\": \"string\",\n \"ParentEmployeeId\": \"string\",\n \"MatrixManagerId\": \"string\",\n \"LanguageId\": \"string\",\n \"Department\": \"string\",\n \"HireDate\": \"2025-05-27T06:24:47.194Z\",\n \"HrbpId\": \"string\",\n \"EmployeeId\": \"string\",\n \"FirstName\": \"string\",\n \"LastName\": \"string\",\n \"FullName\": \"string\",\n \"Gender\": \"string\",\n \"Position\": \"string\",\n \"Location\": \"string\",\n \"Country\": \"string\",\n \"TimeZone\": \"string\",\n \"PhoneNumber\": \"string\",\n \"ImageUrl\": \"string\",\n \"OrganizationLevelId\": 0,\n \"IsActive\": true,\n \"IsLeft\": true,\n \"IsWhiteCollar\": true,\n \"GeneratePassword\": true,\n \"ExternalAccountList\": [\n {\n \"IdentityProvider\": \"string\"\n }\n ],\n \"IsTopManagement\": true,\n \"IsGeneralManager\": true,\n \"ExtendedAuthorizationReportId\": 0,\n \"ExtendedAuthorizationAdminPanelId\": 0,\n \"ExtendedAuthorizationCompanyObjectiveId\": 0,\n \"IsProxyAdmin\": true,\n \"Unsubscribe\": true,\n \"NotificationUserId\": \"string\",\n \"Password\": \"string\",\n \"IsPerformanceIncluded\": true,\n \"BusinessUnit\": \"string\",\n \"HrbpEmail\": \"string\",\n \"MatrixManagerEmail\": \"string\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{baseUrl}}/identity/api/application-user","description":"

Request Parameters:

Parameter	Type	Description
`TenantId*`	integer	ID of the tenant the user is affiliated with.
`CompanyId*`	integer	ID of the company the user belongs to.
`UserName`	string	Username of the user (typically a unique system identifier).
`Email*`	string	User’s email address. Required for login and communication.
`ParentId**`	string	ID of the user's manager (optional).
`ParentEmail**`	string	Email address of the user's manager (alternative to ParentId).
`ParentEmployeeId**`	string	Employee ID of the user's manager (optional).
`MatrixManagerId`	string	ID of the matrix manager (if applicable).
`LanguageId*`	string	Language code (e.g., \"EN\", \"TR\") used in the UI.
`Department*`	string	Department name to which the user is assigned.
`HireDate*`	datetime	Employment start date. Format: `YYYY-MM-DDTHH:MM:SSZ`
`HrbpId`	string	ID of the HRBP (Human Resources Business Partner).
`EmployeeId`	string	Employee ID assigned by the company (optional).
`FirstName*`	string	User's first name.
`LastName*`	string	User's last name.
`FullName*`	string	User's full name.
`Gender*`	string	Gender (\"M\", \"F\", or \"X\" for unknown/unspecified).
`Position*`	string	Job title or position of the user.
`Location*`	string	User's office or working location.
`Country*`	string	Country of residence (ISO code, e.g., \"TR\").
`TimeZone*`	string	User’s time zone (e.g., \"UTC+3\").
`PhoneNumber`	string	User’s contact phone number (optional).
`ImageUrl`	string	URL of the user’s profile image (optional).
`OrganizationLevelId`	integer	Organizational level ID if applicable.
`IsActive`	boolean	Whether the user account is currently active. Default true
`IsLeft`	boolean	Whether the user has left the company. Default false
`IsWhiteCollar`	boolean	Whether the user is a white-collar worker.
`GeneratePassword***`	boolean	If `true`, system will generate a password for the user.
`ExternalAccountList[].IdentityProvider***`	string	Identity provider name (e.g., \"Microsoft\") for external login.
`IsTopManagement`	boolean	Whether the user is part of the top management.
`IsGeneralManager`	boolean	Whether the user is a general manager.
`ExtendedAuthorizationReportId****`	integer	ID for extended authorization related to report access. Possible values: 0, 1, or 10 (optional).
`ExtendedAuthorizationAdminPanelId****`	integer	ID for extended authorization for admin panel access. Possible values: 0, 1, or 10 (optional).
`ExtendedAuthorizationCompanyObjectiveId****`	integer	ID for extended authorization related to company objectives. Possible values: 0, 1, or 10 (optional).
`IsProxyAdmin****`	boolean	Whether the user has proxy admin rights.
`Unsubscribe`	boolean	Whether the user unsubscribed from notifications.
`IsPerformanceIncluded`	boolean	Whether the user is included in performance processes. Default true
`BusinessUnit`	string	User's business unit (optional).

Legend

* Required field.
\n
** Only one of the parent user-related fields (ParentId, ParentEmail, or ParentEmployeeId) should be provided.
\n
*** During create operations, only one of ExternalAccountList or GeneratePassword must be provided.
\n
**** For ExtendedAuthorizationReportId, ExtendedAuthorizationAdminPanelId, and ExtendedAuthorizationCompanyObjectiveId:
\n
- 0 = No access
  \n
- 1 = Read-only access
  \n
- 10 = Edit access
  \n
\n
If IsProxyAdmin is set to true, then ExtendedAuthorizationAdminPanelId must be 10.
\n

\n","urlObject":{"protocol":"https","path":["identity","api","application-user"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"8d98c7ae-038b-4332-b670-10c749cae7d4","name":"User Create","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"Email\": \"john.doe@google.com\",\n \"ParentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"MatrixManagerId\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"LanguageId\": \"EN\",\n \"Department\": \"Optimization\",\n \"HireDate\": \"2025-04-27T06:24:47.194Z\",\n \"HrbpId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"EmployeeId\": \"DE00181\",\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"FullName\": \"John Doe\",\n \"Gender\": \"X\",\n \"Position\": \"Customer Communications Specialist\",\n \"Location\": \"London\",\n \"Country\": \"UK\",\n \"TimeZone\": \"UTC+0\",\n \"PhoneNumber\": \"01111111111\",\n \"ImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"IsActive\": true,\n \"IsLeft\": false,\n \"IsWhiteCollar\": true,\n \"GeneratePassword\": true,\n \"IsTopManagement\": false,\n \"IsGeneralManager\": false,\n \"ExtendedAuthorizationReportId\": 0,\n \"ExtendedAuthorizationAdminPanelId\": 0,\n \"ExtendedAuthorizationCompanyObjectiveId\": 1,\n \"IsProxyAdmin\": false,\n \"Unsubscribe\": false,\n \"IsPerformanceIncluded\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.twiser.com/identity/api/application-user"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"UserName\": \"26417ac8-6bd6-43e2-b661-5602f6ed0d54\",\n \"Email\": \"john.doe@google.com\",\n \"DepartmentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"Department\": \"Optimization\",\n \"BusinessUnit\": null,\n \"ParentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"ParentUser\": {\n \"Id\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"FirstName\": \"Uriah\",\n \"LastName\": \"Reichel\",\n \"Email\": \"UriahReichel@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Uriah Reichel\",\n \"ImageUrl\": null\n },\n \"MatrixManagerId\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"MatrixManager\": {\n \"Id\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"FirstName\": \"Enos\",\n \"LastName\": \"Reynolds\",\n \"Email\": null,\n \"EmployeeId\": null,\n \"FullName\": \"Enos Reynolds\",\n \"ImageUrl\": null\n },\n \"LanguageId\": \"en\",\n \"HireDate\": \"2025-04-27T06:24:47.194Z\",\n \"ExitDate\": null,\n \"IsPerformanceIncluded\": true,\n \"IsHRBPManager\": false,\n \"HrbpId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"HrbpUser\": {\n \"Id\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"FirstName\": \"Deanna\",\n \"LastName\": \"Bayer\",\n \"Email\": \"DeannaBayer@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Deanna Bayer\",\n \"ImageUrl\": null\n },\n \"EmployeeId\": \"DE00181\",\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"FullName\": \"John Doe\",\n \"Gender\": \"X\",\n \"Position\": \"Customer Communications Specialist\",\n \"Location\": \"London\",\n \"Country\": \"UK\",\n \"TimeZone\": \"UTC+0\",\n \"ImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevelId\": null,\n \"GetHierarchyId\": null,\n \"GetHierarchyLevel\": null,\n \"HasPassword\": true,\n \"ExternalAccountList\": null,\n \"GetDepartmentOfUser\": {\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"Name\": \"Optimization\",\n \"ManagerUserName\": \"John Doe\",\n \"ManagerUserImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevel\": null,\n \"HierarchyId\": null,\n \"IsActive\": false,\n \"DepartmentHierarchy\": null,\n \"CreatedBy\": null,\n \"CreatedAt\": \"0001-01-01T00:00:00\",\n \"ChangedBy\": null,\n \"ChangedAt\": null\n },\n \"IsFirstLogin\": true,\n \"IsActive\": true,\n \"IsLeft\": false,\n \"IsWhiteCollar\": true,\n \"CreatedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"CreatedAt\": \"2025-05-27T06:40:40.9287663Z\",\n \"ChangedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"ChangedAt\": \"2025-05-27T06:40:40.9287663Z\",\n \"IsTopManagement\": false,\n \"IsGeneralManager\": null,\n \"ExtendedAuthorizationReportId\": null,\n \"ExtendedAuthorizationAdminPanelId\": null,\n \"ExtendedAuthorizationCompanyObjectiveId\": 1,\n \"IsProxyAdmin\": false,\n \"IsDeleted\": false,\n \"Unsubscribe\": false,\n \"NotificationUserId\": null,\n \"PhoneNumber\": \"01111111111\"\n}"}],"_postman_id":"1fb7e91f-629f-41a0-a1c6-cc959075f2e2"},{"name":"User Update","id":"18bd44e6-6cb8-49ae-a003-fb0647de49f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Id\": \"string\",\n \"TenantId\": 0,\n \"CompanyId\": 0,\n \"Email\": \"string\",\n \"ParentId\": \"string\",\n \"ParentEmail\": \"string\",\n \"ParentEmployeeId\": \"string\",\n \"MatrixManagerId\": \"string\",\n \"LanguageId\": \"string\",\n \"Department\": \"string\",\n \"HireDate\": \"2025-05-27T06:24:47.194Z\",\n \"HrbpId\": \"string\",\n \"EmployeeId\": \"string\",\n \"FirstName\": \"string\",\n \"LastName\": \"string\",\n \"FullName\": \"string\",\n \"Gender\": \"string\",\n \"Position\": \"string\",\n \"Location\": \"string\",\n \"Country\": \"string\",\n \"TimeZone\": \"string\",\n \"PhoneNumber\": \"string\",\n \"ImageUrl\": \"string\",\n \"OrganizationLevelId\": 0,\n \"IsActive\": true,\n \"IsLeft\": true,\n \"IsWhiteCollar\": true,\n \"IsTopManagement\": true,\n \"IsGeneralManager\": true,\n \"ExtendedAuthorizationReportId\": 0,\n \"ExtendedAuthorizationAdminPanelId\": 0,\n \"ExtendedAuthorizationCompanyObjectiveId\": 0,\n \"IsProxyAdmin\": true,\n \"Unsubscribe\": true,\n \"NotificationUserId\": \"string\",\n \"Password\": \"string\",\n \"IsPerformanceIncluded\": true,\n \"BusinessUnit\": \"string\",\n \"HrbpEmail\": \"string\",\n \"MatrixManagerEmail\": \"string\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{baseUrl}}/identity/api/application-user","description":"

Request Parameters:

Parameter	Type	Description
`TenantId*`	integer	ID of the tenant the user is affiliated with.
`CompanyId*`	integer	ID of the company the user belongs to.
`Id*`	string	Unique user ID. If provided, an update will be performed.
`UserName`	string	Username of the user (typically a unique system identifier).
`Email*`	string	User’s email address. Required for login and communication.
`ParentId**`	string	ID of the user's manager (optional).
`ParentEmail**`	string	Email address of the user's manager (alternative to ParentId).
`ParentEmployeeId**`	string	Employee ID of the user's manager (optional).
`MatrixManagerId`	string	ID of the matrix manager (if applicable).
`LanguageId*`	string	Language code (e.g., \"EN\", \"TR\") used in the UI.
`Department*`	string	Department name to which the user is assigned.
`HireDate*`	datetime	Employment start date. Format: `YYYY-MM-DDTHH:MM:SSZ`
`ExitDate`	datetime	Employment end date (if applicable). Format: `YYYY-MM-DDTHH:MM:SSZ`.
`HrbpId`	string	ID of the HRBP (Human Resources Business Partner).
`EmployeeId`	string	Employee ID assigned by the company (optional).
`FirstName*`	string	User's first name.
`LastName*`	string	User's last name.
`FullName*`	string	User's full name.
`Gender*`	string	Gender (\"M\", \"F\", or \"X\" for unknown/unspecified).
`Position*`	string	Job title or position of the user.
`Location*`	string	User's office or working location.
`Country*`	string	Country of residence (ISO code, e.g., \"TR\").
`TimeZone*`	string	User’s time zone (e.g., \"UTC+3\").
`PhoneNumber`	string	User’s contact phone number (optional).
`ImageUrl`	string	URL of the user’s profile image (optional).
`OrganizationLevelId`	integer	Organizational level ID if applicable.
`IsActive`	boolean	Whether the user account is currently active. Default true
`IsLeft`	boolean	Whether the user has left the company. Default false
`IsWhiteCollar`	boolean	Whether the user is a white-collar worker.
`IsTopManagement`	boolean	Whether the user is part of the top management.
`IsGeneralManager`	boolean	Whether the user is a general manager.
`ExtendedAuthorizationReportId***`	integer	ID for extended authorization related to report access (optional).
`ExtendedAuthorizationAdminPanelId***`	integer	ID for extended authorization for admin panel access (optional).
`ExtendedAuthorizationCompanyObjectiveId***`	integer	ID for extended authorization related to company objectives (optional).
`IsProxyAdmin***`	boolean	Whether the user has proxy admin rights.
`Unsubscribe`	boolean	Whether the user unsubscribed from notifications.
`IsPerformanceIncluded`	boolean	Whether the user is included in performance processes. Default true
`BusinessUnit`	string	User's business unit (optional).

Legend

* Required field.
\n
** Only one of the parent user-related fields (ParentId, ParentEmail, or ParentEmployeeId) should be provided.
\n
*** For ExtendedAuthorizationReportId, ExtendedAuthorizationAdminPanelId, and ExtendedAuthorizationCompanyObjectiveId:
\n
- 0 = No access
  \n
- 1 = Read-only access
  \n
- 10 = Edit access
  \n
\n
If IsProxyAdmin is set to true, then ExtendedAuthorizationAdminPanelId must be 10.
\n

\n","urlObject":{"protocol":"https","path":["identity","api","application-user"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"a433a358-c115-4abe-be2d-a298dc2b5f42","name":"User Create","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"Email\": \"john.doe@google.com\",\n \"ParentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"MatrixManagerId\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"LanguageId\": \"EN\",\n \"Department\": \"Optimization\",\n \"HireDate\": \"2025-04-27T06:24:47.194Z\",\n \"HrbpId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"EmployeeId\": \"DE00181\",\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"FullName\": \"John Doe\",\n \"Gender\": \"X\",\n \"Position\": \"Customer Communications Specialist\",\n \"Location\": \"London\",\n \"Country\": \"UK\",\n \"TimeZone\": \"UTC+0\",\n \"PhoneNumber\": \"01111111111\",\n \"ImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"IsActive\": true,\n \"IsLeft\": false,\n \"IsWhiteCollar\": true,\n \"IsTopManagement\": false,\n \"IsGeneralManager\": false,\n \"ExtendedAuthorizationReportId\": 0,\n \"ExtendedAuthorizationAdminPanelId\": 0,\n \"ExtendedAuthorizationCompanyObjectiveId\": 1,\n \"IsProxyAdmin\": false,\n \"Unsubscribe\": false,\n \"IsPerformanceIncluded\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.twiser.com/identity/api/application-user"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"UserName\": \"26417ac8-6bd6-43e2-b661-5602f6ed0d54\",\n \"Email\": \"john.doe@google.com\",\n \"DepartmentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"Department\": \"Optimization\",\n \"BusinessUnit\": null,\n \"ParentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"ParentUser\": {\n \"Id\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"FirstName\": \"Uriah\",\n \"LastName\": \"Reichel\",\n \"Email\": \"UriahReichel@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Uriah Reichel\",\n \"ImageUrl\": null\n },\n \"MatrixManagerId\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"MatrixManager\": {\n \"Id\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"FirstName\": \"Enos\",\n \"LastName\": \"Reynolds\",\n \"Email\": null,\n \"EmployeeId\": null,\n \"FullName\": \"Enos Reynolds\",\n \"ImageUrl\": null\n },\n \"LanguageId\": \"en\",\n \"HireDate\": \"2025-04-27T06:24:47.194Z\",\n \"ExitDate\": null,\n \"IsPerformanceIncluded\": true,\n \"IsHRBPManager\": false,\n \"HrbpId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"HrbpUser\": {\n \"Id\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"FirstName\": \"Deanna\",\n \"LastName\": \"Bayer\",\n \"Email\": \"DeannaBayer@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Deanna Bayer\",\n \"ImageUrl\": null\n },\n \"EmployeeId\": \"DE00181\",\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"FullName\": \"John Doe\",\n \"Gender\": \"X\",\n \"Position\": \"Customer Communications Specialist\",\n \"Location\": \"London\",\n \"Country\": \"UK\",\n \"TimeZone\": \"UTC+0\",\n \"ImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevelId\": null,\n \"GetHierarchyId\": null,\n \"GetHierarchyLevel\": null,\n \"HasPassword\": true,\n \"ExternalAccountList\": null,\n \"GetDepartmentOfUser\": {\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"Name\": \"Optimization\",\n \"ManagerUserName\": \"John Doe\",\n \"ManagerUserImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevel\": null,\n \"HierarchyId\": null,\n \"IsActive\": false,\n \"DepartmentHierarchy\": null,\n \"CreatedBy\": null,\n \"CreatedAt\": \"0001-01-01T00:00:00\",\n \"ChangedBy\": null,\n \"ChangedAt\": null\n },\n \"IsFirstLogin\": true,\n \"IsActive\": true,\n \"IsLeft\": false,\n \"IsWhiteCollar\": true,\n \"CreatedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"CreatedAt\": \"2025-05-27T06:40:40.9287663Z\",\n \"ChangedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"ChangedAt\": \"2025-05-27T06:40:40.9287663Z\",\n \"IsTopManagement\": false,\n \"IsGeneralManager\": null,\n \"ExtendedAuthorizationReportId\": null,\n \"ExtendedAuthorizationAdminPanelId\": null,\n \"ExtendedAuthorizationCompanyObjectiveId\": 1,\n \"IsProxyAdmin\": false,\n \"IsDeleted\": false,\n \"Unsubscribe\": false,\n \"NotificationUserId\": null,\n \"PhoneNumber\": \"01111111111\"\n}"}],"_postman_id":"18bd44e6-6cb8-49ae-a003-fb0647de49f8"},{"name":"User Delete (change status isleft)","id":"68511968-0ddd-409e-9173-886e588951df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{auth_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Id\": \"string\",\n \"ExitDate\": \"2025-05-27T06:24:47.194Z\"\n \n}","options":{"raw":{"language":"json"}}},"url":"https://{{baseUrl}}/identity/api/application-user","description":"

Request Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
`ExitDate\\*`	datetime	Employment exit date. Format: YYYY-MM-DDTHH:MM:SSZ
`Id\\*`	string	Unique user ID. If provided, an update will be performed.

","urlObject":{"protocol":"https","path":["identity","api","application-user"],"host":["{{baseUrl}}"],"query":[],"variable":[]}},"response":[{"id":"09cf2ad6-0ee4-4bc5-881b-63cbd9dcb361","name":"User Delete","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"ExitDate\": \"2025-04-27T06:24:47.194Z\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.twiser.com/identity/api/application-user"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"UserName\": \"26417ac8-6bd6-43e2-b661-5602f6ed0d54\",\n \"Email\": null,\n \"DepartmentId\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"Department\": \"Optimization\",\n \"BusinessUnit\": null,\n \"ParentId\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"ParentUser\": {\n \"Id\": \"b423816a-293d-479e-b99d-b423cd67e078\",\n \"FirstName\": \"Uriah\",\n \"LastName\": \"Reichel\",\n \"Email\": \"UriahReichel@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Uriah Reichel\",\n \"ImageUrl\": null\n },\n \"MatrixManagerId\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"MatrixManager\": {\n \"Id\": \"58be1621-b16d-46a5-ac8e-8d0f15c2d0c8\",\n \"FirstName\": \"Enos\",\n \"LastName\": \"Reynolds\",\n \"Email\": null,\n \"EmployeeId\": null,\n \"FullName\": \"Enos Reynolds\",\n \"ImageUrl\": null\n },\n \"LanguageId\": \"en\",\n \"HireDate\": \"2025-04-27T06:24:47.194\",\n \"ExitDate\": \"2025-04-27T06:24:47.194Z\",\n \"IsPerformanceIncluded\": false,\n \"IsHRBPManager\": false,\n \"HrbpId\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"HrbpUser\": {\n \"Id\": \"04384ad6-887c-4623-bde4-e421a6b1832b\",\n \"FirstName\": \"Deanna\",\n \"LastName\": \"Bayer\",\n \"Email\": \"DeannaBayer@google.com\",\n \"EmployeeId\": null,\n \"FullName\": \"Deanna Bayer\",\n \"ImageUrl\": null\n },\n \"EmployeeId\": null,\n \"FirstName\": \"John\",\n \"LastName\": \"Doe\",\n \"FullName\": \"John Doe\",\n \"Gender\": \"X\",\n \"Position\": \"Customer Communications Specialist\",\n \"Location\": \"London\",\n \"Country\": \"UK\",\n \"TimeZone\": \"UTC+0\",\n \"ImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevelId\": null,\n \"GetHierarchyId\": \"/11/2/1/\",\n \"GetHierarchyLevel\": null,\n \"HasPassword\": true,\n \"ExternalAccountList\": null,\n \"GetDepartmentOfUser\": {\n \"Id\": \"c372016f-79d0-4d3f-ae70-077a781ee3c2\",\n \"TenantId\": 60,\n \"CompanyId\": 360,\n \"Name\": \"Optimization\",\n \"ManagerUserName\": \"John Doe\",\n \"ManagerUserImageUrl\": \"https://i.imgur.com/CzXTtJV.jpg\",\n \"OrganizationLevel\": null,\n \"HierarchyId\": \"/11/2/1/\",\n \"IsActive\": false,\n \"DepartmentHierarchy\": null,\n \"CreatedBy\": null,\n \"CreatedAt\": \"0001-01-01T00:00:00\",\n \"ChangedBy\": null,\n \"ChangedAt\": null\n },\n \"IsFirstLogin\": true,\n \"IsActive\": false,\n \"IsLeft\": true,\n \"IsWhiteCollar\": true,\n \"CreatedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"CreatedAt\": \"2025-05-27T06:40:40.9287663\",\n \"ChangedBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"ChangedAt\": \"2025-06-27T08:17:41.1014346Z\",\n \"IsTopManagement\": false,\n \"IsGeneralManager\": null,\n \"ExtendedAuthorizationReportId\": null,\n \"ExtendedAuthorizationAdminPanelId\": null,\n \"ExtendedAuthorizationCompanyObjectiveId\": 1,\n \"IsProxyAdmin\": false,\n \"IsDeleted\": true,\n \"Unsubscribe\": null,\n \"NotificationUserId\": null,\n \"PhoneNumber\": \"01111111111\"\n}"}],"_postman_id":"68511968-0ddd-409e-9173-886e588951df"}],"id":"fb785cd0-85b3-4140-8e08-4c55dfe65efb","_postman_id":"fb785cd0-85b3-4140-8e08-4c55dfe65efb","description":""}],"id":"30131dc2-0ec7-442d-9371-ebd24a9b8ab7","description":"

This document outlines the User and Identity Management (Identity Service) API for Twiser products.

All integration APIs operate based on company and tenant contexts. Tenant information and access credentials are provided exclusively by Twiser through a dedicated platform. Without valid company and tenant information, no operations can be performed via the APIs.

⚠️ Important Note for On-Premise Deployments

For clients using on-premise deployments of Twiser products, some of the configurations and access requirements outlined in this document may differ. This includes, but is not limited to:

API base URLs
\n
SSL certificate management and trust policies
\n
Internal firewall and proxy configurations
\n
Email whitelisting domains and SMTP routing
\n
Identity service integration and authentication flows
\n

Please consult your Twiser implementation consultant or system administrator to ensure that the relevant configurations are adapted for your internal environment.

Prerequisites for API Usage

Before initiating data integration with Twiser products, it is recommended to verify the following technical requirements:

Firewall configurations
\n
Email whitelisting settings
\n
SSL certificate installation
\n
Access to API endpoints
\n

Email Whitelisting

To ensure that system-generated emails are delivered properly, you may need to whitelist the domains of the following email addresses:

Firewall Settings and Environment Information

Twiser products use a socket connection to enable real-time data transfer between the front-end and back-end. In some organizations, this type of connection might be blocked due to network restrictions. To avoid connection issues, make sure the following domains are allowed through your firewall:

Integration Testing Environment:

UI: https://wokr-demo.twiser.com
\n
API: https://api-demo.twiser.com
\n

Production Environment:

UI: https://wokr.twiser.com
\n
API: https://api.twiser.com
\n

SSL Certificate

Our SSL certificates are public and readily accessible. You can export the certificate using the links below. The same certificate is used for both the integration and production environments:

Integration: https://wokr-demo.twiser.com
\n
Production: https://wokr.twiser.com
\n

\n","_postman_id":"30131dc2-0ec7-442d-9371-ebd24a9b8ab7"},{"name":"LXP User Integration Document V1","item":[{"name":"Login","item":[{"name":"Identity Authentication","id":"2ac22db2-9571-429d-85d8-b80db81e730a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"Email\": \"sample@sample.com\",\n \"Password\": \"password\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/identityv2/Authentication/login","description":"

A client must authenticate by calling a login before executing other api calls. Login method requires a ‘email’ and ‘password’ parameters needs to be provided. You may obtain this information from your sales contact.

Request Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
Email	String	The e-mail information used in the authorization process. For users without an email address, this field must be filled with either the employee's personnel number.
Password	String	The password information used in the authorization process.

Response Parameters:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Description
UserId	UserId is the unique information of user created in Twiser.
CompanyId	It is the company identification number to which the user is affiliated.
IsFirstLogin	It’s the indication whether its first login or not.
LoginProvider	Login provider information
AccessTokenExpiryTime	Token expiration time
AccessToken	An access token is required to call any other api's. AccessToken needs to be passed through as `<Authorization: Bearer 'accessToken'>` tag in request header
RefreshTokenExpiryTime	Renewed token expiry time
RefreshToken	RefreshToken
Message	Message status

","urlObject":{"protocol":"https","path":["lms","identityv2","Authentication","login"],"host":["lxp-api-demo","twiser","com"],"query":[],"variable":[]}},"response":[{"id":"111913c5-9519-4a78-8ce9-2bc9753bcecd","name":"Identity Authentication","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"Email\": \"sample@sample.com\",\n \"Password\": \"password\"\n}\n","options":{"raw":{"language":"json"}}},"url":"https://api.twiser.com/lms/identityv2/Authentication/login"},"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"SessionId\": \"358d9668-e1be-483a-a120-ac5d4debcade\",\n \"UserId\": \"7007c9f4-8865-4766-afc8-e7e3fc0a7901\",\n \"CompanyId\": 3,\n \"IsFirstLogin\": false,\n \"LoginProvider\": \"TWiser\",\n \"AccessTokenExpiryTime\": \"2025-04-23T18:38:53.722538Z\",\n \"AccessToken\": \"eyJhbGciOiJIUzI1iIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InN1ZGVtQHN1Y2Nlc3Npb25tYWlsLmNvbSIsInN1YiI6Ij5MkRBMkJGLTlFMEItNURCOEE3RUM1Q0E4NiIsInRlbmFudGlkIjoiMSIsImNvbXBhbnlpZCI6IjYiLCJsYW5ndWFnZWlkIjoidHIiLCJBdXRob3JpemVkVXNlcklkIjoiNTkyREEyQkYtOUUwQi00RI5LThEM0QtREI4QTdFQzVDQTg2IiwiY29tcGFueWNvZGUiOiIwMzU4XzAzNTgiLCJBdXRob3JpemVkQ29tcGFueSI6IjAzNThfMDM1OCIsIkF1dGhvcml6ZWRDb21wYW55SWRzIjoiNiIsIm5iZiI6MTc0NTMwMzYwMiwiZXhwIjoxNzQ1NDI1MjAyLCJpYXQiOjE3NDUzMDM2MDIsImlzcyI6Imh0dHBzOi8vYXBpLWRldi50d2lzZXIuY29tcHM6Ly9sbXMtZGV2LnR3aXNlci5jb20ifQckssbp243KVl9NLY_LcwEiqCd3_aChoerYdZDLFitiU\",\n \"RefreshTokenExpiryTime\": \"2025-04-30T18:38:53.722538Z\",\n \"RefreshToken\": \"0itwUfOYdlHQua9OokWPYpzwEkfyNTmau5f4yO5VFOs=\",\n \"Message\": \"Success\"\n}\n"}],"_postman_id":"2ac22db2-9571-429d-85d8-b80db81e730a"}],"id":"50467c5c-41d6-489b-bcb7-a9604b654e22","_postman_id":"50467c5c-41d6-489b-bcb7-a9604b654e22","description":""},{"name":"User","item":[{"name":"Get User List","id":"d766eef7-4e97-43e1-b440-ec738591ccfc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{accessToken}}"}]},"isInherited":false},"method":"POST","header":[],"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/get-by-company-id?CompanyId=1&PageNumber=1&PageSize=15","urlObject":{"protocol":"https","path":["lms","backoffice","user","get-by-company-id"],"host":["lxp-api-demo","twiser","com"],"query":[{"key":"CompanyId","value":"1"},{"key":"PageNumber","value":"1"},{"key":"PageSize","value":"15"}],"variable":[]}},"response":[{"id":"d045e5a3-5e5a-49c6-a800-07a79342cfa3","name":"Get User List","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"}],"url":{"raw":"https://lxp-api-demo.twiser.com/lms/backoffice/user/get-by-company-id?CompanyId=1&PageNumber=1&PageSize=15","protocol":"https","host":["lxp-api-demo","twiser","com"],"path":["lms","backoffice","user","get-by-company-id"],"query":[{"key":"CompanyId","value":"1"},{"key":"PageNumber","value":"1"},{"key":"PageSize","value":"15"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"15ed4042-4e7f-4c28-a7f9-497be71af93a\",\n \"tenantId\": 56,\n \"companyId\": 94,\n \"userName\": \"cekoqe@mailinator.com\",\n \"email\": \"cekoqe@mailinator.com\",\n \"languageId\": \"tr\",\n \"firstName\": \"Xandra\",\n \"lastName\": \"Church\",\n \"fullName\": \"Xandra Church\",\n \"gender\": \"F\",\n \"location\": \"Nostrud et vero aliq\",\n \"country\": \"TR\",\n \"timeZone\": \"UTC+3\",\n \"hasPassword\": false,\n \"isFirstLogin\": true,\n \"isActive\": true,\n \"createdBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"createdAt\": \"2025-10-17T06:55:55.9215351\",\n \"externalUserId\": \"jyzerimu\"\n },\n {\n \"id\": \"4193D369-E398-4CEC-BB46-E4F3C203C5B0\",\n \"tenantId\": 56,\n \"companyId\": 94,\n \"userName\": \"def@twiser.com\",\n \"email\": \"def@twiser.com\",\n \"languageId\": \"tr\",\n \"firstName\": \"Ali\",\n \"lastName\": \"Yee\",\n \"fullName\": \"Ali Yee\",\n \"gender\": \"I\",\n \"location\": \"Istanbul\",\n \"country\": \"TR\",\n \"timeZone\": \"UTC+3\",\n \"hasPassword\": false,\n \"isFirstLogin\": false,\n \"isActive\": true,\n \"createdBy\": \"3f5fd09f-0bf2-4ff4-89e4-72b1cbed18ce\",\n \"createdAt\": \"2024-10-21T10:19:33\",\n \"changedAt\": \"2024-10-21T10:19:39\"\n }\n ],\n \"totalItemCount\": 2,\n \"maxPage\": 1,\n \"currentPage\": 1\n}"}],"_postman_id":"d766eef7-4e97-43e1-b440-ec738591ccfc"},{"name":"Create User","id":"19e2daec-d911-4137-bee1-92b05cf29977","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{accessToken}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"string\", \n \"externalUserId\":\"string\",\n \"managerEmail\": \"string\",\n \"managerId\": \"string\",\n \"languageId\": \"string\",\n \"department\": \"string\",\n \"firstName\": \"string\", \n \"lastName\": \"string\",\n \"gender\": \"string\",\n \"position\": \"string\",\n \"companyId\": 0,\n \"location\": \"string\",\n \"country\": \"string\",\n \"password\": \"string\",\n \"welcomeMail\": true,\n \"userRole\":\"string\",\n \"notification\": \"string\",\n \"phoneNumber\":\"String\",\n \"isActive\": true\n\n}\n","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/create","description":"

It is used for creating User for LXP application

Request Parameters:

Parameter	Type	Description
email	String	It is the user's email information. Email field will be required to login to user interface. For users without an email address, this field must be filled with either the employee's personnel number or unique ID.
externalUserId	String	It is unique information provided by the customer. It can be used to send and retrieve data via Update User, Delete User Method and also reporting purpose on User Interface.
managerEmail	String	The first manager email of the user. If the manager information will not be sent, this field must be send as null.
managerId	String	The first manager of the user. The unique ID of his/her immediate supervisor must be given in this field. If the manager information will not be sent, this field must be send as null.
languageId	String	Default language information for the user. 2 languages are supported. Turkish (\"TR\"), English (\"EN\").
department	String	This field represents the user's department within the company and should be provided as text. It is used in My Team individual profile information, and department-based filters. This field is optional.
firstName	String	The name of the user.
lastName	String	Last lastname of the user.
gender	String	Gender information of the user. \"M\" or \"F\" values can be sent. This field is optional.
position	String	This field represents the user's position within the company and should be provided as text. It is used in My Team page, individual profile information, and position-based filters. It does not include any system integration or position hierarchy.
companyId	String	Company information to which the user is affiliated. companyId is a required field and can be obtained from the response of \"Identity Authentication (Login)\" method
location	String	Location information of the user. It is optionally used for reporting or viewing purposes.
country	String	Country information of the user. It is optionally used for reporting or display purposes.
password	String	The password the user will use to log into the system. This is an optional field. If It is left as blank, the system will generate a password instead also its recommended to use with Welcome Mail as True in order to notify to user regarding password generated by system. For users without an email address, a password can be set here to allow system access.
welcomeMail	Boolean	If set to true, newly created users will receive a \"welcome mail\" notification that contains the Password. Otherwise user will not be notified regarding the password or new account creation.
userRole	String	Determines the user's role within the application. The values \"Admin\" or \"User\" can be entered. If the user is assigned as \"Admin,\" he/she will have access to the administration panel. If left as an \"empty\", the default value will be set to \"User.\"
notification	String	Accepts Yes or No values. When set to Yes, the user will receive email notifications and push notifications related to the application.
phoneNumber	String	This field is used to enter the phone number that the user will use to log into the system. It is not a mandatory field. If the user prefers to log in with an email, it can be left blank. If provided, the user must enter an 11-digit phone number starting with 05.
isActive	Boolean	The field that indicates whether the user is active or passive.

Error Message Table:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

errorCode	Fields	Error Message
1001	firstName, lastName, email, companyId, notification	\"The following required fields are missing: firstName, lastName, email, companyId, notification.\"
1401	managerId	\"Manager not found”
1402	companyId	“Company not found with companyId:1”
1405	firstName, lastName, department, position, email	“The following fields exceed their maximum allowed character limits: firstName (150), lastName (150), email (150), department (255), position (255).”
1403	email	“There is already another user registered with the same email”
1404	phoneNumber	“Please enter a valid phone number.”

","urlObject":{"protocol":"https","path":["lms","backoffice","user","create"],"host":["lxp-api-demo","twiser","com"],"query":[],"variable":[]}},"response":[{"id":"5658c0f0-04f6-4ca7-9b73-b7a5009f8f54","name":"Create User","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{auth_token}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"email\": \"john.doe@google.com\",\n \"department\": \"HR\",\n \"position\": \"HR Specialist\",\n \"gender\": \"F\",\n \"languageId\": \"TR\",\n \"managerEmail\":\"test@test.com\",\n \"companyId\": 94,\n \"location\": \"Istanbul\",\n \"country\": \"TR\",\n \"welcomeMail\": true,\n \"userRole\": \"User\",\n \"isEmailExemption\": false,\n \"isPushNotificationExemption\": false\n}\n","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"id\": \"6c04ecae-f3ae-2da6-835d-8377f23997ff\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"fullName\": \"John Doe\",\n \"languageId\": \"tr\",\n \"gender\": \"F\",\n \"location\": \"Istanbul\",\n \"country\": \"TR\",\n \"timeZone\": \"UTC+3\",\n \"externalUserId\": null,\n \"phoneNumber\": null,\n \"userRole\": \"Standard\",\n \"birthDate\": \"0001-01-01T00:00:00\",\n \"email\": \"john.doe@google.com\",\n \"identityNumber\": null,\n \"imageUrl\": null,\n \"companyId\": 94,\n \"tenantId\": 56,\n \"departmentId\": 331,\n \"departmentName\": \"Hr\",\n \"positionId\": 582,\n \"positionName\": \"Hr Specialist\",\n \"managerId\": \"2ce4d89b-cdda-44c6-938e-c6e19effef9e\",\n \"gradeId\": null,\n \"dateOfStart\": null,\n \"dateOfEnd\": null,\n \"isTopManager\": false,\n \"isManager\": false,\n \"isCriticRole\": false,\n \"isCeo\": false,\n \"isGeneralManager\": false,\n \"isPrinciple\": false,\n \"isAdmin\": false,\n \"manager\": {\n \"id\": \"2ce4d89b-cdda-44c6-938e-c6e19effef9e\",\n \"firstName\": \"test\",\n \"lastName\": \"test\",\n \"fullName\": \"test test\",\n \"languageId\": null,\n \"gender\": null,\n \"location\": null,\n \"country\": null,\n \"timeZone\": null,\n \"externalUserId\": null,\n \"phoneNumber\": null,\n \"userRole\": null,\n \"birthDate\": \"0001-01-01T00:00:00\",\n \"email\": null,\n \"identityNumber\": null,\n \"imageUrl\": null,\n \"companyId\": 0,\n \"tenantId\": 0,\n \"departmentId\": null,\n \"departmentName\": null,\n \"positionId\": null,\n \"positionName\": null,\n \"managerId\": null,\n \"gradeId\": null,\n \"dateOfStart\": null,\n \"dateOfEnd\": null,\n \"isTopManager\": false,\n \"isManager\": false,\n \"isCriticRole\": false,\n \"isCeo\": false,\n \"isGeneralManager\": false,\n \"isPrinciple\": false,\n \"isAdmin\": false,\n \"manager\": null,\n \"isEmailExemption\": false,\n \"isPushNotificationExemption\": false\n },\n \"isEmailExemption\": false,\n \"isPushNotificationExemption\": false\n}"},{"id":"658b6e3a-ea91-4ee8-8a01-c1a2c27391f2","name":"Error message examples","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"string\", \n \"externalUserId\":\"string\",\n \"managerId\": \"string\",\n \"languageId\": \"string\",\n \"department\": \"string\",\n \"firstName\": \"string\", \n \"lastName\": \"string\",\n \"gender\": \"string\",\n \"position\": \"string\",\n \"companyId\": 0,\n \"location\": \"string\",\n \"country\": \"string\",\n \"password\": \"string\",\n \"welcomeMail\": true,\n \"userRole\":\"string\",\n \"notification\": \"string\",\n \"phoneNumber\":\"String\",\n \"isActive\": true\n\n}\n","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/create"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"type\": \"https://tools.ietf.org/html/rfc9110#section-15.5.1\",\n \"title\": \"One or more validation errors occurred.\",\n \"status\": 400,\n \"errors\": [\n {\n \"propertyName\": \"FirstName\",\n \"errorMessage\": \"The following required fields are missing: FirstName\",\n \"errorCode\": 1001\n },\n {\n \"propertyName\": \"LastName\",\n \"errorMessage\": \"The following required fields are missing: LastName\",\n \"errorCode\": 1001\n },\n {\n \"propertyName\": \"PhoneNumber\",\n \"errorMessage\": \"Please enter a valid phone number\",\n \"errorCode\": 1404\n },\n {\n \"propertyName\": \"CompanyId\",\n \"errorMessage\": \"Company not found with companyId: 365\",\n \"errorCode\": 1402\n },\n {\n \"propertyName\": \"ManagerId\",\n \"errorMessage\": \"Manager not found.\",\n \"errorCode\": 1401\n }\n ]\n}"}],"_postman_id":"19e2daec-d911-4137-bee1-92b05cf29977"},{"name":"Update User","id":"0bd81c79-99af-47cd-843a-88a2a1580f6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{accessToken}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": \"string\", \n \"email\":\"string\",\n \"externalUserId\":\"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"managerEmail\": \"string\",\n \"managerId\": \"string\",\n \"languageId\": \"string\",\n \"gender\": \"string\",\n \"isActive\": true,\n \"isDeleted\": false,\n \"department\": \"string\",\n \"position\": \"string\",\n \"location\": \"string\",\n \"country\": \"string\",\n \"userRole\":\"string\",\n \"notification\":\"string\",\n \"password\":\"string\",\n \"phoneNumber\":\"string\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/update ","urlObject":{"protocol":"https","path":["lms","backoffice","user","update "],"host":["lxp-api-demo","twiser","com"],"query":[],"variable":[]}},"response":[{"id":"4438e43b-26f2-4b25-b330-3b5b0c104521","name":"Update User","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"john.doe@google.com\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"managerId\": null,\n \"languageId\": \"tr\",\n \"gender\": \"F\",\n \"department\": \"Hr\",\n \"position\": \"Hr Specialist\",\n \"location\": \"New York\",\n \"country\": \"TR\",\n \"userRole\": \"User\",\n \"isEmailExemption\": false,\n \"isPushNotificationExemption\": false,\n \"Id\": \"6c04ecae-f3ae-2da6-835d-8377f23997ff\"\n}","options":{"raw":{"language":"json"}}},"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/update "},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"id\": \"6c04ecae-f3ae-2da6-835d-8377f23997ff\",\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"fullName\": \"John Doe\",\n \"languageId\": \"tr\",\n \"gender\": \"F\",\n \"location\": \"New York\",\n \"country\": \"TR\",\n \"timeZone\": \"UTC+3\",\n \"externalUserId\": null,\n \"phoneNumber\": null,\n \"userRole\": \"Standard\",\n \"birthDate\": \"0001-01-01T00:00:00\",\n \"email\": \"john.doe@google.com\",\n \"identityNumber\": null,\n \"imageUrl\": null,\n \"companyId\": 94,\n \"tenantId\": 56,\n \"departmentId\": 331,\n \"departmentName\": \"Hr\",\n \"positionId\": 582,\n \"positionName\": \"Hr Specialist\",\n \"managerId\": null,\n \"gradeId\": null,\n \"dateOfStart\": null,\n \"dateOfEnd\": null,\n \"isTopManager\": false,\n \"isManager\": false,\n \"isCriticRole\": false,\n \"isCeo\": false,\n \"isGeneralManager\": false,\n \"isPrinciple\": false,\n \"isAdmin\": false,\n \"manager\": null,\n \"isEmailExemption\": false,\n \"isPushNotificationExemption\": false\n}"}],"_postman_id":"0bd81c79-99af-47cd-843a-88a2a1580f6b"},{"name":"Delete User","id":"3d271a26-c66d-4eee-80e9-58f1b7d4af76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{accessToken}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://lxp-api-demo.twiser.com/lms/backoffice/user/delete?id={{userId}}","urlObject":{"protocol":"https","path":["lms","backoffice","user","delete"],"host":["lxp-api-demo","twiser","com"],"query":[{"key":"id","value":"{{userId}}"}],"variable":[]}},"response":[{"id":"073dd7c5-4b97-4316-a70e-b095b685df12","name":"Delete User","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://lxp-api-demo.twiser.com/lms/backoffice/user/delete?id= 6c04ec7e-f3ae-4da6-835d-8377f23997ff","protocol":"https","host":["lxp-api-demo","twiser","com"],"path":["lms","backoffice","user","delete"],"query":[{"key":"id","value":" 6c04ec7e-f3ae-4da6-835d-8377f23997ff"}]}},"status":"No Content","code":204,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":""}],"_postman_id":"3d271a26-c66d-4eee-80e9-58f1b7d4af76"}],"id":"8a6262b5-6712-4877-9481-5076d0cd1bcf","description":"

It is used to get User list for LXP application

\n","_postman_id":"8a6262b5-6712-4877-9481-5076d0cd1bcf"}],"id":"0a0dbd94-7d0d-4aec-924f-08d4a3ab1eb1","description":"

This document outlines the User and Identity Management (Identity Service) API for LXP products.

⚠️ Important Note for On-Premise Deployments

For clients using on-premise deployments of Twiser products, some of the configurations and access requirements outlined in this document may differ. This includes, but is not limited to:

API base URLs
\n
SSL certificate management and trust policies
\n
Internal firewall and proxy configurations
\n
Email whitelisting domains and SMTP routing
\n
Identity service integration and authentication flows
\n

Please consult your Twiser implementation consultant or system administrator to ensure that the relevant configurations are adapted for your internal environment.

Prerequisites for API Usage

Before initiating data integration with Twiser products, it is recommended to verify the following technical requirements:

Firewall configurations
\n
Email whitelisting settings
\n
SSL certificate installation
\n
Access to API endpoints
\n

Email Whitelisting

To ensure that system-generated emails are delivered properly, you may need to whitelist the domains of the following email addresses:

Firewall Settings and Environment Information

Demo Testing Environment:

UI: https://lxp-demo.twiser.com/
\n
API: https://lxp-api-demo.twiser.com/
\n

Production Environment:

UI: https://lxp.twiser.com/
\n
API: https://api.twiser.com/
\n

SSL Certificate

Our SSL certificates are public and readily accessible. You can export the certificate using the links below. The same certificate is used for both the demo and production environments:

Demo: https://lxp-demo.twiser.com/
\n
Production: https://lxp.twiser.com/
\n

\n","_postman_id":"0a0dbd94-7d0d-4aec-924f-08d4a3ab1eb1"}]}