{"info":{"_postman_id":"86361310-1030-4e3f-b8d1-e08e1295fb9d","name":"TalentPulse Develop Integration","description":"

This is the Accendo Technologies API documentation for third-party integrations of TalentPulse Develop Module. This collection of APIs allow an integration to be built to post organization chart and employee profiles data into TalentPulse.

\n

Workflow

\n

The integration is split into two parts:

\n\n

Integration Diagram

\n\n\n

Process Flow

\n\n\n

Frequency

\n

Recommended frequency is typically weekly. If changes are rare, the frequency can be reduced.

\n

Can also be adhoc (as of when needed).

\n

Base URL

\n

All API requests to be sent to a base URL provided by Accendo. Two URLs will be given for Dev/UAT and Production.

\n

Authentication

\n

Please request for credentials from Accendo.

\n

Include the following headers on all requests to Accendo API.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KeyValueDescription
keyxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxUUID
tokenxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx60 characters string
\n

Error Codes

\n

The standard REST API status codes will be returned when invalid payload or server error happens.

\n

4xx: Client error (e.g. validation errors)

\n

5xx: Server error, please reach out to Accendo

\n

Changelog

\n
July 27, 2023
\n\n
February 23, 2024
\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Workflow","slug":"workflow"},{"content":"Base URL","slug":"base-url"},{"content":"Authentication","slug":"authentication"},{"content":"Error Codes","slug":"error-codes"},{"content":"Changelog","slug":"changelog"}],"owner":"11033489","collectionId":"86361310-1030-4e3f-b8d1-e08e1295fb9d","publishedId":"TzJvecZD","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2023-07-27T13:43:57.000Z"},"item":[{"name":"Post Org Chart","id":"616754fd-25f5-424b-bcc4-44a5a48f58eb","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"org_chart\": [\n {\n \"job_id\": \"AC_0342342\",\n \"job_title\": \"CEO\",\n \"directorate\": \"CEO Group Division\",\n \"division\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"layer\": \"J10\",\n \"employee_id\": 220,\n \"employee_name\": \"Taylor Stephens\",\n \"email_address\": \"taylor@getnada.com\",\n \"reporting_job_id\": \"\",\n \"reporting_employee_id\": \"\",\n \"reporting_employee_email\": \"\",\n \"reporting_employee_name\": \"\",\n \"role_priority\": 1,\n \"job_level\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": true,\n \"is_root\": \"yes\"\n },\n {\n \"job_id\": \"AC_0342343\",\n \"job_title\": \"CTO\",\n \"directorate\": \"CEO Group Division\",\n \"division\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"layer\": \"J10\",\n \"employee_id\": 221,\n \"employee_name\": \"Andrea Reeves\",\n \"email_address\": \"andrea@getnada.com\",\n \"reporting_job_id\": \"AC_0342342\",\n \"reporting_employee_id\": 220,\n \"reporting_employee_email\": \"taylor@getnada.com\",\n \"reporting_employee_name\": \"Taylor\",\n \"role_priority\": 1,\n \"bench_strength\": 1,\n \"is_mission_critical_position\": true,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_0342344\",\n \"job_title\": \"CFO\",\n \"directorate\": \"CFO Group Division\",\n \"division\": \"CFO Group Division\",\n \"department\": \"CFO Group Division\",\n \"unit\": \"UNIT OF CFO\",\n \"layer\": \"J10\",\n \"employee_id\": 222,\n \"employee_name\": \"Rhonda Lyons\",\n \"email_address\": \"rhonda@getnada.com\",\n \"reporting_job_id\": \"AC_0342342\",\n \"reporting_employee_id\": 220,\n \"reporting_employee_email\": \"taylor@getnada.com\",\n \"reporting_employee_name\": \"Taylor\",\n \"role_priority\": 1,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_0342345\",\n \"job_title\": \"Engineering Manager\",\n \"directorate\": \"Engineering\",\n \"division\": \"Engineering Division\",\n \"department\": \"Engineering\",\n \"unit\": \"Engineering Unit\",\n \"layer\": \"E10\",\n \"employee_id\": 333455,\n \"employee_name\": \"Francis Cherry\",\n \"email_address\": \"francis@getnada.com\",\n \"reporting_job_id\": \"AC_0342343\",\n \"reporting_employee_id\": 221,\n \"reporting_employee_email\": \"andrea@getnada.com\",\n \"reporting_employee_name\": \"Andrea Reeves\",\n \"role_priority\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": true,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_034234566\",\n \"job_title\": \"Engineering Manager\",\n \"directorate\": \"Engineering\",\n \"division\": \"Engineering Division\",\n \"department\": \"Engineering\",\n \"unit\": \"Engineering Unit\",\n \"layer\": \"E10\",\n \"employee_id\": 333455,\n \"employee_name\": \"Robbie McCarthy\",\n \"email_address\": \"robbie@getnada.com\",\n \"reporting_job_id\": \"AC_0342343\",\n \"reporting_employee_id\": 221,\n \"reporting_employee_email\": \"andrea@getnada.com\",\n \"reporting_employee_name\": \"Andrea Reeves\",\n \"role_priority\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": false,\n \"job_level\": 10,\n \"is_root\": \"no\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/orgChart/postOrgChartDataV1","description":"

Integrate organization chart data.

\n\n

Request Params

\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
ParameterTypeDescription
job_idstringRequired. Must be unique.

The unique ID of the role.
job_titlestringRequired. Max 255 characters.

The title of the role.
directoratestringMax 255 characters.

The highest level of group or category of the role.
divisionstringMax 255 characters.

The division of the role.
departmentstringMax 255 characters.

The department of the role.
unitstringMax 255 characters.

The unit of the role.
layerstringMax 255 characters.

The layer of the role.
employee_idstringThe unique ID of the employee.
employee_namestringRequired if not vacant role. Max 255 characters.

The name of the employee.
email_addressstringRequired if not vacant role.

The email address of the employee.
reporting_job_idstringRequired if not root.

The unique role ID of the reporting role. Only the ONE root role should be blank.
reporting_employee_idstringThe unique employee ID of the manager.
reporting_employee_emailstringRequired if not vacant role.

The email address of the manager.
reporting_employee_namestringRequired if not vacant role.

The name of the manager.
role_priorityintegerBetween 1 to 99.

To determine which role's priority, used when there are double hat situations for an employee.

1 = Primary role
2 = Secondary role
3,4,5 ... as per the sequence set by source system
job_levelinteger**Required.

**The job level of the role.
bench_strengthintegerThe number of minimum required successors for the role.
is_mission_critical_positionbooleanIndicates if the role mission critical in the organization.
Defaults to \"false\".

Options: true, false
is_rootstringRequired. Must have 1 record with \"yes\".

To indicate whether this role is the root of the org-chart.
Only ONE role that does not has reporting line should put \"yes\", other roles should put \"no\".
Defaults to \"no\".

Options: yes, no
\n

The sample below will form an org-chart with the root role at center:

\n","urlObject":{"path":["api","integration","orgChart","postOrgChartDataV1"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"29f98676-cde7-4e4c-927e-3edcd0f19058","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"org_chart\": [\n {\n \"job_id\": \"AC_0342342\",\n \"job_title\": \"CEO\",\n \"directorate\": \"CEO Group Division\",\n \"division\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"layer\": \"J10\",\n \"employee_id\": 220,\n \"employee_name\": \"Taylor Stephens\",\n \"email_address\": \"taylor@getnada.com\",\n \"reporting_job_id\": \"\",\n \"reporting_employee_id\": \"\",\n \"reporting_employee_email\": \"\",\n \"reporting_employee_name\": \"\",\n \"role_priority\": 1,\n \"job_level\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": true,\n \"is_root\": \"yes\"\n },\n {\n \"job_id\": \"AC_0342343\",\n \"job_title\": \"CTO\",\n \"directorate\": \"CEO Group Division\",\n \"division\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"layer\": \"J10\",\n \"employee_id\": 221,\n \"employee_name\": \"Andrea Reeves\",\n \"email_address\": \"andrea@getnada.com\",\n \"reporting_job_id\": \"AC_0342342\",\n \"reporting_employee_id\": 220,\n \"reporting_employee_email\": \"taylor@getnada.com\",\n \"reporting_employee_name\": \"Taylor\",\n \"role_priority\": 1,\n \"bench_strength\": 1,\n \"is_mission_critical_position\": true,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_0342344\",\n \"job_title\": \"CFO\",\n \"directorate\": \"CFO Group Division\",\n \"division\": \"CFO Group Division\",\n \"department\": \"CFO Group Division\",\n \"unit\": \"UNIT OF CFO\",\n \"layer\": \"J10\",\n \"employee_id\": 222,\n \"employee_name\": \"Rhonda Lyons\",\n \"email_address\": \"rhonda@getnada.com\",\n \"reporting_job_id\": \"AC_0342342\",\n \"reporting_employee_id\": 220,\n \"reporting_employee_email\": \"taylor@getnada.com\",\n \"reporting_employee_name\": \"Taylor\",\n \"role_priority\": 1,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_0342345\",\n \"job_title\": \"Engineering Manager\",\n \"directorate\": \"Engineering\",\n \"division\": \"Engineering Division\",\n \"department\": \"Engineering\",\n \"unit\": \"Engineering Unit\",\n \"layer\": \"E10\",\n \"employee_id\": 333455,\n \"employee_name\": \"Francis Cherry\",\n \"email_address\": \"francis@getnada.com\",\n \"reporting_job_id\": \"AC_0342343\",\n \"reporting_employee_id\": 221,\n \"reporting_employee_email\": \"andrea@getnada.com\",\n \"reporting_employee_name\": \"Andrea Reeves\",\n \"role_priority\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": true,\n \"job_level\": 2,\n \"is_root\": \"no\"\n },\n {\n \"job_id\": \"AC_034234566\",\n \"job_title\": \"Engineering Manager\",\n \"directorate\": \"Engineering\",\n \"division\": \"Engineering Division\",\n \"department\": \"Engineering\",\n \"unit\": \"Engineering Unit\",\n \"layer\": \"E10\",\n \"employee_id\": 333455,\n \"employee_name\": \"Robbie McCarthy\",\n \"email_address\": \"robbie@getnada.com\",\n \"reporting_job_id\": \"AC_0342343\",\n \"reporting_employee_id\": 221,\n \"reporting_employee_email\": \"andrea@getnada.com\",\n \"reporting_employee_name\": \"Andrea Reeves\",\n \"role_priority\": 1,\n \"bench_strength\": 2,\n \"is_mission_critical_position\": false,\n \"job_level\": 10,\n \"is_root\": \"no\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/orgChart/postOrgChartDataV1"},"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 \"data\": {\n \"status\": \"IN_PROGRESS\",\n \"message\": \"OrgChart integration started\"\n },\n \"meta\": {\n \"timestamp\": {\n \"date\": \"2023-07-28 02:46:14.468615\",\n \"timezone_type\": 3,\n \"timezone\": \"Asia/Kuala_Lumpur\"\n },\n \"url\": \"http://journey-backend.test/api/integration/orgChart/postOrgChartDataV1\",\n \"correlationId\": \"a33bb9b4-1e39-4205-9856-193cc57cb99f\",\n \"status_code\": 200,\n \"message\": \"Success!\"\n }\n}"},{"id":"e02ad88b-b1c0-44ac-9e05-81e5f6777fa8","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"org_chart\": [\n {\n \"job_id\": \"AC_0342342\",\n \"job_title\": \"CEO\",\n \"directorate\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"employee_id\": null,\n \"employee_name\": \"Taylor Stephens\",\n \"email_address\": \"taylor@getnada.com\",\n \"reporting_job_id\": null,\n \"reporting_employee_id\": null,\n \"reporting_employee_email\": null,\n \"reporting_employee_name\": null,\n \"role_priority\": null,\n \"job_level\": \"\",\n \"bench_strength\": 0,\n \"is_mission_critical_position\": true,\n \"is_root\": \"yes\"\n },\n {\n \"job_id\": \"AC_0342343\",\n \"job_title\": \"CTO\",\n \"directorate\": \"CEO Group Division\",\n \"department\": \"CEO Group Division\",\n \"unit\": \"UNIT OF CEO\",\n \"employee_id\": null,\n \"employee_name\": \"Andrea Reeves\",\n \"email_address\": \"andrea@getnada.com\",\n \"reporting_job_id\": \"AC_0342342\",\n \"reporting_employee_email\": \"taylor@getnada.com\",\n \"reporting_employee_name\": \"Taylor\",\n \"role_priority\": 1,\n \"bench_strength\": 0,\n \"is_mission_critical_position\": true,\n \"job_level\": 1,\n \"is_root\": \"yes\"\n },\n {\n \"job_id\": \"AC_0342344\",\n \"job_title\": \"CFO\",\n \"directorate\": \"CFO Group Division\",\n \"department\": \"CFO Group Division\",\n \"unit\": \"UNIT OF CFO\",\n \"employee_id\": null,\n \"employee_name\": \"Rhonda Lyons\",\n \"email_address\": \"rhonda@getnada.com\",\n \"reporting_job_id\": \"\",\n \"reporting_employee_email\": \"\",\n \"reporting_employee_name\": \"\",\n \"role_priority\": 1,\n \"bench_strength\": 0,\n \"is_mission_critical_position\": false,\n \"job_level\": 1,\n \"is_root\": \"no\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/orgChart/postOrgChartDataV1"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"meta\": {\n \"timestamp\": {\n \"date\": \"2023-07-28 02:48:09.269308\",\n \"timezone_type\": 3,\n \"timezone\": \"Asia/Kuala_Lumpur\"\n },\n \"url\": \"http://journey-backend.tp.test/api/integration/orgChart/postOrgChartDataV1\",\n \"correlationId\": \"2901ec0c-464b-49ce-9f24-921bb1a9e587\",\n \"errorMessage\": \"The given data was invalid\",\n \"errorString\": \"UNKNOWN_ERROR\",\n \"status_code\": 422,\n \"message\": \"Failure!!\"\n },\n \"errors\": {\n \"org_chart\": \"The multiple root positions are not allowed in the org chart data. Check `is_root` field\",\n \"org_chart.2.reporting_job_id\": \"The Reporting Job Id value is required. job_id: (AC_0342344)\",\n \"org_chart.0.job_level\": \"The Job Level field is required. job_id: (AC_0342342)\"\n }\n}"}],"_postman_id":"616754fd-25f5-424b-bcc4-44a5a48f58eb"},{"name":"Post Talent Profile","id":"49919819-74f2-4602-94b7-bc6a6b50c9e9","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"talent_profiles\": [\n {\n \"employee_id\": 220,\n \"employee_name\": \"Taylor Stephens\",\n \"employee_email\": \"taylor@getnada.com\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\",\n \"date_of_birth\": \"1962-01-21\",\n \"contact_number\": \"110000001\",\n \"gender\": \"Female\",\n \"nationality\": \"Malaysia\",\n \"address_line_1\": \"A-1-1 Mid Valley\",\n \"address_line_2\": \"JL. MT HA 1\",\n \"city\": \"Shah Alam\",\n \"state\": \"Selangor\",\n \"post_code\": \"50000\",\n \"country\": \"Malaysia\",\n \"marital_status\": \"Married\",\n \"no_of_children\": 2,\n \"linkedin_url\": \"https://www.linkedin.com/test-user-25\",\n \"employee_grade\": \"HRL2\",\n \"join_date_company\": \"2022-01-21\",\n \"join_date_role\": \"2022-01-21\",\n \"employement_type\": \"Full-Time\",\n \"total_years_of_experience\": 2.5,\n \"last_promotion_date\": \"2022-01-21\",\n \"willingness_for_mobility\": \"High\",\n \"vacancy_risk\": \"Yes\",\n \"emergency_cover\": \"Yes\",\n \"experience\": [\n {\n \"start_date\": \"2021-01-21\",\n \"end_date\": \"2021-01-22\",\n \"title\": \"HR\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"is_working_here\": true\n },\n {\n \"start_date\": \"2022-01-21\",\n \"end_date\": \"2023-04-21\",\n \"title\": \"IT\",\n \"company_name\": \"some company 2\",\n \"company_location\": \"Selangor\",\n \"is_working_here\": false\n }\n ],\n \"education\": [\n {\n \"start_date\": \"2021-01-21\",\n \"end_date\": \"2021-01-21\",\n \"institution\": \"INTI\",\n \"qualification\": \"Bachelor Degree\",\n \"field_of_study\": \"IT\"\n },\n {\n \"start_date\": \"2023-01-21\",\n \"end_date\": \"2025-01-21\",\n \"institution\": \"INTI\",\n \"qualification\": \"MAster Degree\",\n \"field_of_study\": \"AI\"\n }\n ],\n \"certifications\": [\n {\n \"issue_date\": \"2022-01-22\",\n \"expiration_date\": \"2023-01-22\",\n \"certification_name\": \"Internal Audit Practitioner Program\",\n \"issuing_organization\": \"IAP\"\n },\n {\n \"issue_date\": \"2023-03-21\",\n \"expiration_date\": \"2024-03-21\",\n \"certification_name\": \"Certified Internal Auditor\",\n \"issuing_organization\": \"CIA\"\n }\n ],\n \"performance_ratings\": [\n {\n \"year\": 2023,\n \"rating\": 5,\n \"description\": \"Good\",\n \"completion_date\": \"2023-01-21\",\n \"remarks\": \"Shown good performance on risk management\"\n },\n {\n \"year\": 2022,\n \"rating\": 4,\n \"description\": \"Exceptional\",\n \"completion_date\": \"2022-01-21\"\n },\n {\n \"year\": 2021,\n \"rating\": 3,\n \"description\": \"Outstanding\",\n \"completion_date\": \"2021-01-21\"\n }\n ],\n \"key_achievements\": [\n {\n \"achievements\": \"Suggested improvements to risk management framework improving process efficiency by 30%\"\n },\n {\n \"achievements\": \"Developed risk reports for client and management review\"\n }\n ]\n },\n {\n \"employee_id\": 221,\n \"employee_name\": \"Andrea Reeves\",\n \"employee_email\": \"andrea@getnada.com\",\n \"date_of_birth\": \"1990-01-21\",\n \"gender\": \"Male\",\n \"nationality\": \"malaysia\",\n \"address_line_1\": \"A-1-1 Mid Valley\",\n \"address_line_2\": \"JL. MT HA 1\",\n \"country\": \"Malaysia\",\n \"state\": \"Kuala Lumpur\",\n \"marital_status\": \"Married\",\n \"no_of_children\": 2,\n \"post_code\": \"100001\",\n \"city\": \"Shah Alam\",\n \"contact_number\": \"110000002\",\n \"join_date_company\": \"1990-01-21\",\n \"employee_grade\": \"HRL2\",\n \"employee_group\": \"GL1\",\n \"rater_employee_id\": 220,\n \"rater_employee_name\": \"Taylor Stephens\",\n \"rater_email\": \"taylor@getnada.com\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\",\n \"duration_of_assignment\": \"Contract\",\n \"linkedin_url\": \"https://www.linkedin.com/test-user-22\",\n \"total_years_of_experience\": 2.5,\n \"education\": [\n {\n \"institution\": \"INTI\",\n \"qualification\": \"Degree or ACCA\",\n \"field_of_study\": \"IT\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-01\"\n },\n {\n \"institution\": \"INTI\",\n \"qualification\": \"MAster Degree\",\n \"field_of_study\": \"AI\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\"\n }\n ],\n \"performance_ratings\": [\n {\n \"year\": 2021,\n \"rating\": 4,\n \"description\": \"Well Done\"\n },\n {\n \"year\": 2020,\n \"rating\": 4,\n \"description\": \"Exceptional Work\"\n },\n {\n \"year\": 2019,\n \"rating\": 3,\n \"description\": \"Outstanding\"\n }\n ],\n \"training_hours\": [\n {\n \"year\": 2021,\n \"training_hours_completed\": 60\n },\n {\n \"year\": 2020,\n \"training_hours_completed\": 20\n },\n {\n \"year\": 2019,\n \"training_hours_completed\": 40\n }\n ],\n \"training\": [\n {\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\",\n \"duration\": \"1 day\",\n \"training_topic\": \"Management Leadership\",\n \"education_type\": \"Management\"\n },\n {\n \"start_date\": \"2000-01-21\",\n \"end_date\": \"2021-01-20\",\n \"duration\": \"5 months\",\n \"training_topic\": \"Management Leadership 2\",\n \"education_type\": \"Management\"\n }\n ],\n \"experience\": [\n {\n \"title\": \"HR\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\"\n },\n {\n \"title\": \"IT\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"start_date\": \"1993-01-21\",\n \"end_date\": \"1996-01-21\"\n }\n ],\n \"key_achievements\": [\n {\n \"achievements\": \"Suggested improvements to risk management framework improving process efficiency by 30%\"\n },\n {\n \"achievements\": \"Developed risk reports for client and management review\"\n }\n ],\n \"certifications\": [\n {\n \"certification_name\": \"Internal Audit Practitioner Program\",\n \"issuing_organization\": \"IAP\",\n \"issue_date\": \"2022-01-22\",\n \"expiration_date\": \"2023-01-22\"\n },\n {\n \"certification_name\": \"Certified Internal Auditor\",\n \"issuing_organization\": \"CIA\",\n \"issue_date\": \"2023-03-21\",\n \"expiration_date\": \"2024-03-21\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/talentProfile/postTalentProfileDataV1","description":"

Integrate talent profile data.

\n\n

Request Params

\n

General Profile

\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\n
ParameterTypeDescription
employee_idstringUnique identifier for each employee. This should not be repeated or reused.
employee_namestringRequired.
Full name of the employee
employee_emailstringRequired. Must be unique. Must be exist in org chart.

Email address of the employee. This should be a valid email address and unique for each employee.
company_codestringUnique code that identifies the company within your organization
company_namestringLegal name of the company the employee works for
date_of_birthdate (YYYY-MM-DD)Employee's date of birth
contact_numberstringEmployee's contact number
genderstringEmployee’s gender

Options: Male, Female
nationalitystringEmployee's nationality as stated on their passport
address_line_1stringEmployee's residential address
address_line_2stringAdditional details about the employee's residence, if necessary
citystringCity
statestringState
post_codestringMax 10 characters.
countrystringCountry
marital_statusstringMarital status
no_of_childrenintegerNumber of children
linkedin_urlstringLink to LinkedIn profile
employee_gradestringCurrent organizational grade/level
join_date_companydate (YYYY-MM-DD)Date of joining the company
join_date_roledate (YYYY-MM-DD)Date of assuming current role
employee_typestringType of employment contract
total_years_of_experiencenumericYears worked in profession, including other firms
last_promotion_datestringDate of the last promotion
willingness_for_mobilitystringIndicates relocation willingness
vacancy_riskstringLikelihood of leaving position
emergency_coverstringAbility to handle emergencies/extra roles
\n

The following sections can be multi-record per employee.

\n

Experience

\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
ParameterTypeDescription
start_datedate (YYYY-MM-DD)The start date of the employee's tenure at the company
end_datedate (YYYY-MM-DD)The end date of the employee's tenure at the company
titlestringThe position the employee held at the company
company_namestringThe company where the employee gained work experience
company_locationstringThe location of the company where the employee worked
is_working_herebooleanSpecify if this is current employment
\n

Education

\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
ParameterTypeDescription
start_datedate (YYYY-MM-DD)The start date of the qualification
end_datedate (YYYY-MM-DD)The end date of the qualification
institutionstringThe institution where the qualification was obtained
qualificationstringThe qualification obtained
field_of_studystringThe field of study for the qualification obtained
\n

Certifications

\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
ParameterTypeDescription
issue_datedate (YYYY-MM-DD)The start date of the employee's tenure at the company
expiration_datedate (YYYY-MM-DD)The end date of the employee's tenure at the company
certification_namestringThe position the employee held at the company
issuing_organizationstringThe company where the employee gained work experience
\n

Performance Information

\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
ParameterTypeDescription
yearintegerThe performance review year
ratingintegerThe performance rating obtained by the employee in that year
descriptionstringA brief description of the employee's performance
completion_datedate (YYYY-MM-DD)The date when the performance review was completed
remarksstringAny additional remarks or comments on the employee's performance
\n

Key Achievements

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeDescription
achievementsstringA description of achievements that the employee made
\n
","urlObject":{"path":["api","integration","talentProfile","postTalentProfileDataV1"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"65413d40-f858-40d4-b29b-046ce9b7256e","name":"Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"talent_profiles\": [\n {\n \"employee_id\": 220,\n \"employee_name\": \"Taylor Stephens\",\n \"employee_email\": \"taylor@getnada.com\",\n \"date_of_birth\": \"1962-01-21\",\n \"gender\": \"Female\",\n \"nationality\": \"Malaysia\",\n \"address_line_1\": \"A-1-1 Mid Valley\",\n \"address_line_2\": \"JL. MT HA 1\",\n \"country\": \"Malaysia\",\n \"state\": \"Selangor\",\n \"marital_status\": \"Married\",\n \"no_of_children\": 2,\n \"post_code\": \"50000\",\n \"city\": \"Shah Alam\",\n \"contact_number\": \"110000001\",\n \"join_date_company\": \"2022-01-21\",\n \"employee_grade\": \"HRL2\",\n \"employee_group\": \"GL1\",\n \"rater_employee_id\": \"\",\n \"rater_employee_name\": \"\",\n \"rater_email\": \"\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\",\n \"duration_of_assignment\": \"Less than 1 year\",\n \"linkedin_url\": \"https://www.linkedin.com/test-user-25\",\n \"total_years_of_experience\": 2.5,\n \"education\": [\n {\n \"institution\": \"INTI\",\n \"qualification\": \"Bachelor Degree\",\n \"field_of_study\": \"IT\",\n \"start_date\": \"2021-01-21\",\n \"end_date\": \"2021-01-21\"\n },\n {\n \"institution\": \"INTI\",\n \"qualification\": \"MAster Degree\",\n \"field_of_study\": \"AI\",\n \"start_date\": \"2023-01-21\",\n \"end_date\": \"2025-01-21\"\n }\n ],\n \"performance_ratings\": [\n {\n \"year\": 2021,\n \"rating\": 5,\n \"description\": \"Good\",\n \"completion_date\": \"2021-01-21\",\n \"remarks\": \"Shown good performance on risk management\"\n },\n {\n \"year\": 2020,\n \"rating\": 4,\n \"description\": \"Exceptional\",\n \"completion_date\": \"2020-01-21\"\n },\n {\n \"year\": 2019,\n \"rating\": 3,\n \"description\": \"Outstanding\",\n \"completion_date\": \"2019-01-21\"\n }\n ],\n \"training_hours\": [\n {\n \"year\": 2021,\n \"training_hours_completed\": 70\n },\n {\n \"year\": 2020,\n \"training_hours_completed\": 10\n },\n {\n \"year\": 2019,\n \"training_hours_completed\": 40\n }\n ],\n \"training\": [\n {\n \"start_date\": \"2021-01-21\",\n \"end_date\": \"2021-01-21\",\n \"duration\": \"1 month\",\n \"training_topic\": \"Management Leadership\",\n \"education_type\": \"Management\"\n },\n {\n \"start_date\": \"2022-01-21\",\n \"end_date\": \"2022-05-21\",\n \"duration\": \"3 days\",\n \"training_topic\": \"Management Leadership 2\",\n \"education_type\": \"Management\"\n }\n ],\n \"experience\": [\n {\n \"title\": \"HR\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"start_date\": \"2021-01-21\",\n \"end_date\": \"2021-01-22\"\n },\n {\n \"title\": \"IT\",\n \"company_name\": \"some company 2\",\n \"company_location\": \"Selangor\",\n \"start_date\": \"2022-01-21\",\n \"end_date\": \"2023-04-21\"\n }\n ],\n \"key_achievements\": [\n {\n \"achievements\": \"Suggested improvements to risk management framework improving process efficiency by 30%\"\n },\n {\n \"achievements\": \"Developed risk reports for client and management review\"\n }\n ],\n \"certifications\": [\n {\n \"certification_name\": \"Internal Audit Practitioner Program\",\n \"issuing_organization\": \"IAP\",\n \"issue_date\": \"2022-01-22\",\n \"expiration_date\": \"2023-01-22\"\n },\n {\n \"certification_name\": \"Certified Internal Auditor\",\n \"issuing_organization\": \"CIA\",\n \"issue_date\": \"2023-03-21\",\n \"expiration_date\": \"2024-03-21\"\n }\n ]\n },\n {\n \"employee_id\": 221,\n \"employee_name\": \"Andrea Reeves\",\n \"employee_email\": \"andrea@getnada.com\",\n \"date_of_birth\": \"1990-01-21\",\n \"gender\": \"Male\",\n \"nationality\": \"malaysia\",\n \"address_line_1\": \"A-1-1 Mid Valley\",\n \"address_line_2\": \"JL. MT HA 1\",\n \"country\": \"Malaysia\",\n \"state\": \"Kuala Lumpur\",\n \"marital_status\": \"Married\",\n \"no_of_children\": 2,\n \"post_code\": \"100001\",\n \"city\": \"Shah Alam\",\n \"contact_number\": \"110000002\",\n \"join_date_company\": \"1990-01-21\",\n \"employee_grade\": \"HRL2\",\n \"employee_group\": \"GL1\",\n \"rater_employee_id\": 220,\n \"rater_employee_name\": \"Taylor Stephens\",\n \"rater_email\": \"taylor@getnada.com\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\",\n \"duration_of_assignment\": \"Contract\",\n \"linkedin_url\": \"https://www.linkedin.com/test-user-22\",\n \"total_years_of_experience\": 2.5,\n \"education\": [\n {\n \"institution\": \"INTI\",\n \"qualification\": \"Degree or ACCA\",\n \"field_of_study\": \"IT\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-01\"\n },\n {\n \"institution\": \"INTI\",\n \"qualification\": \"MAster Degree\",\n \"field_of_study\": \"AI\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\"\n }\n ],\n \"performance_ratings\": [\n {\n \"year\": 2021,\n \"rating\": 4,\n \"description\": \"Well Done\"\n },\n {\n \"year\": 2020,\n \"rating\": 4,\n \"description\": \"Exceptional Work\"\n },\n {\n \"year\": 2019,\n \"rating\": 3,\n \"description\": \"Outstanding\"\n }\n ],\n \"training_hours\": [\n {\n \"year\": 2021,\n \"training_hours_completed\": 60\n },\n {\n \"year\": 2020,\n \"training_hours_completed\": 20\n },\n {\n \"year\": 2019,\n \"training_hours_completed\": 40\n }\n ],\n \"training\": [\n {\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\",\n \"duration\": \"1 day\",\n \"training_topic\": \"Management Leadership\",\n \"education_type\": \"Management\"\n },\n {\n \"start_date\": \"2000-01-21\",\n \"end_date\": \"2021-01-20\",\n \"duration\": \"5 months\",\n \"training_topic\": \"Management Leadership 2\",\n \"education_type\": \"Management\"\n }\n ],\n \"experience\": [\n {\n \"title\": \"HR\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"start_date\": \"1990-01-21\",\n \"end_date\": \"1990-01-21\"\n },\n {\n \"title\": \"IT\",\n \"company_name\": \"some company\",\n \"company_location\": \"company location\",\n \"start_date\": \"1993-01-21\",\n \"end_date\": \"1996-01-21\"\n }\n ],\n \"key_achievements\": [\n {\n \"achievements\": \"Suggested improvements to risk management framework improving process efficiency by 30%\"\n },\n {\n \"achievements\": \"Developed risk reports for client and management review\"\n }\n ],\n \"certifications\": [\n {\n \"certification_name\": \"Internal Audit Practitioner Program\",\n \"issuing_organization\": \"IAP\",\n \"issue_date\": \"2022-01-22\",\n \"expiration_date\": \"2023-01-22\"\n },\n {\n \"certification_name\": \"Certified Internal Auditor\",\n \"issuing_organization\": \"CIA\",\n \"issue_date\": \"2023-03-21\",\n \"expiration_date\": \"2024-03-21\"\n }\n ]\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/talentProfile/postTalentProfileDataV1"},"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 \"data\": {\n \"status\": \"IN_PROGRESS\",\n \"message\": \"Talent profile integration started\"\n },\n \"meta\": {\n \"timestamp\": {\n \"date\": \"2023-07-28 02:52:16.512732\",\n \"timezone_type\": 3,\n \"timezone\": \"Asia/Kuala_Lumpur\"\n },\n \"url\": \"http://journey-backend.test/api/integration/talentProfile/postTalentProfileDataV1\",\n \"correlationId\": \"0029f7b0-6cfb-4f61-b3d9-8f0cc974a68b\",\n \"status_code\": 200,\n \"message\": \"Success!\"\n }\n}"},{"id":"1aae269b-4419-4b6d-b72c-9d823a6092d9","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"},{"key":"key","type":"text","value":"{{key}}"},{"key":"token","type":"text","value":"{{token}}"}],"body":{"mode":"raw","raw":"{\n \"talent_profiles\": [\n {\n \"employee_id\": \"\",\n \"employee_name\": \"Taylor Stephens\",\n \"employee_email\": \"\",\n \"join_date_company\": \"21/1/2022\",\n \"employee_group\": \"GL1\",\n \"rater_employee_id\": \"\",\n \"rater_employee_name\": \"\",\n \"rater_email\": \"\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\"\n },\n {\n \"employee_id\": \"\",\n \"employee_name\": \"Andrea Reeves\",\n \"employee_email\": \"\",\n \"join_date_company\": \"21/1/2010\",\n \"employee_group\": \"GL1\",\n \"rater_employee_id\": \"\",\n \"rater_employee_name\": \"Taylor Stephens\",\n \"rater_email\": \"taylor@getnada.com\",\n \"company_code\": \"FD12\",\n \"company_name\": \"Company Name\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/integration/talentProfile/postTalentProfileDataV1"},"status":"Unprocessable Entity","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"meta\": {\n \"timestamp\": {\n \"date\": \"2023-07-28 02:56:29.770905\",\n \"timezone_type\": 3,\n \"timezone\": \"Asia/Kuala_Lumpur\"\n },\n \"url\": \"http://journey-backend.test/api/integration/talentProfile/postTalentProfileDataV1\",\n \"correlationId\": \"3587be0c-1b55-4c4a-bf19-78e351dd3f2a\",\n \"errorMessage\": \"The given data was invalid\",\n \"errorString\": \"UNKNOWN_ERROR\",\n \"status_code\": 422,\n \"message\": \"Failure!!\"\n },\n \"errors\": {\n \"talent_profiles.0.employee_email\": \"The Employee Email field is required.\",\n \"talent_profiles.1.employee_email\": \"The Employee Email field is required.\",\n \"talent_profiles.0.join_date_company\": \"The Joining Date Company does not match the format Y-m-d.\",\n \"talent_profiles.1.join_date_company\": \"The Joining Date Company does not match the format Y-m-d.\"\n }\n}"}],"_postman_id":"49919819-74f2-4602-94b7-bc6a6b50c9e9"}],"event":[{"listen":"prerequest","script":{"id":"7a191f03-b591-4023-ae5d-befb4cb93be4","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c551f203-888c-4f23-898d-35ce00bd19c9","type":"text/javascript","exec":[""]}}],"variable":[{"key":"journey_domain","value":"{{base_url}}"},{"key":"key","value":"{{key}}","type":"string"},{"key":"token","value":"{{token}}","type":"string"}]}