Gofive OpenAPI
empeo
VenioeTaxGo
empeo
VenioeTaxGo
  1. Employee
  • Authentication
    • Authorization
      POST
  • Master
    • Get Organizations
      GET
    • Get CustomField
      GET
    • Get Holiday
      GET
    • Get MasterSetup
      GET
    • Get Overtimes
      GET
  • Recruitment
    • Get Candidate
  • Core HR
    • Attendance
      • Get Time Attendance
      • Workin
      • Get Employee WorkIn Site
      • Get Timestamps
      • Get TimeStamp Attachments
      • Get Workin Sites
      • Get IOMO Logs
      • Add Timestamps
    • Asset
      • Get Asset list
      • Update Asset
      • Get Employee Assets
    • Employee
      • Get Employee
        GET
      • Update Employee
        PUT
      • Get Employees List
        GET
      • Get Mastertypes List
        GET
      • Get Name Prefixes
        GET
      • Get Document Types
        GET
      • Update Employee
        POST
      • Add Employee Attachment
        POST
      • Update Employee Address
        POST
      • Update Employee Family
        POST
      • Update Employee Contact
        POST
      • Update Employee Education
        POST
      • Update Employee Experience
        POST
      • Update Employee CustomField
        POST
      • Delete Employee
        POST
      • Get Employee Role
        GET
      • Get Employee Movement Lists
        GET
    • Leave
      • Get Employee Documents
    • Shifts
      • Get Shift Details
      • Update Employee Shifts
      • Get Employee Shifts
      • Swap Employee Shifts
    • Timesheet
      • Search Projects
      • Search Tasks
      • Create Timesheet Entry
  • Payroll
    • Get Financial Transactions
    • Update Financial Transactions
    • Create Loan
    • Get Cost Center
  • Welfare
    • Shuttle Buses
    • Passengers
  • Goals
    • Update KPI
  • Engagement
    • Achievement
      • Get Employee Achievements
      • Create Achievement Card
      • Create Achievement Award Document
      • Get Achievement Events
    • Praise
      • Get Employee Praises
      • Get Praise Types
      • Create Praise Reward Manager
    • StampCard
      • Get Stamp Cards
      • Get Stamp Card Detail
      • Add Stamp
    • Celebration
      • Get Upcoming Celebrations
    • Mission
      • ดึงคิวงานรอตรวจ
      • ดึงรายละเอียดงาน 1 ใบ
      • ดึงตัวเลขสรุปงานตามสถานะ
      • อนุมัติงานหลายใบพร้อมกัน
      • ส่งงานกลับให้แก้หลายใบพร้อมกัน
  • Overtime
    • Get Overtimes Preriods
    • Get Overtimes Documents
  • Employee
    • User Info
    • Update Employee Information
  1. Employee

Update Employee CustomField

POST
https://api.gofive.co.th/empeo/api/v1/employees/custom-fields
บันทึกค่าฟิลด์กำหนดเองของพนักงาน
บันทึกค่าฟิลด์กำหนดเอง (custom field) ของพนักงาน 1 คน — CustomFields เป็น object ที่ key คือชื่อฟิลด์
ตามที่ตั้งไว้ ไม่ใช่รหัส ส่งเฉพาะฟิลด์ที่ต้องการบันทึกก็ได้
📋 ต้องเรียก GET /api/v1/masters/custom-fields ก่อน เพื่อให้ได้ชื่อฟิลด์ ชนิด และตัวเลือกที่ถูกต้อง
ฟิลด์ชนิดเลือกจากรายการต้องส่งค่าที่ตรงกับ Options
ฟิลด์ที่ตั้ง RegularExpression ต้องผ่านรูปแบบนั้น
⚠️ ข้อควรรู้
CustomFields ต้องไม่ว่างและค่าต้องไม่เป็นค่าว่าง ไม่งั้นจะได้ 400
ต่างจาก endpoint แก้ไขข้อมูลอื่นในเอกสารนี้ — อันนี้ตอบ 400 เมื่อไม่สำเร็จ ไม่ใช่ 204
🔐 ต้องมีสิทธิ์ Open API โมดูล Employee ระดับ ReadAndWrite

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Header Params

Body Params application/jsonRequired

Example
{
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme",
    "CustomFields": {
        "ขนาดเสื้อยูนิฟอร์ม": "M",
        "รหัสพนักงานระบบเก่า": "OLD-0001"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.gofive.co.th/empeo/api/v1/employees/custom-fields' \
--header 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "EmployeeRefId": "EMP001",
    "CompanyName": "Acme",
    "CustomFields": {
        "ขนาดเสื้อยูนิฟอร์ม": "M",
        "รหัสพนักงานระบบเก่า": "OLD-0001"
    }
}'

Responses

🟢200OK
application/json
บันทึกสำเร็จ
Bodyapplication/json

Example
{
    "StatusCode": 200,
    "Message": "Saved successfully."
}
🟠400Bad Request
🟠401Unauthorized
🟢200User authentication required V2.
Modified at 2026-08-20 06:06:34
Previous
Update Employee Experience
Next
Delete Employee
Built with