Skip to content

แก้ไขรายชื่อผู้ติดต่อ POST ​

แก้ไขข้อมูลรายชื่อผู้ติดต่อที่มีอยู่ ส่งเฉพาะฟิลด์ที่ต้องการเปลี่ยน ฟิลด์ที่ไม่ส่งจะคงค่าเดิม

Authorization ​

ใช้ API Key (การยืนยันตัวตน) — ส่ง header Authorization: Bearer <API_KEY> (API Key ขึ้นต้นด้วย smsk_)

HTTP Request ​

http
POST https://public-api.smsup-plus.com/Person/updatePerson

Content Type ​

application/json

Parameter Description ​

PropertyTypeRequiredDescription
personIdstringRequiredรหัสรายชื่อที่ต้องการแก้ไข (ต้องเป็นของบัญชีคุณ)
firstNamestringOptionalชื่อใหม่
lastNamestringOptionalนามสกุลใหม่
emailstringOptionalอีเมลใหม่
phonestringOptionalเบอร์โทรใหม่
companyNamestringOptionalชื่อบริษัทใหม่
notestringOptionalหมายเหตุใหม่
tagsstring[]Optionalรายการแท็กใหม่ — แทนที่ทั้งชุด ส่ง [] เพื่อล้างแท็กทั้งหมด ไม่ส่ง (หรือส่ง null) = คงค่าเดิม

Response Description ​

PropertyTypeDescription
statusnumber200 เมื่อสำเร็จ
dataobjectรายชื่อหลังแก้ไข — ฟิลด์เดียวกับ Person

ตัวอย่าง Request ​

bash
curl -X POST 'https://public-api.smsup-plus.com/Person/updatePerson' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "personId": "3f8b2c1e-7a4d-4e9b-9c2f-1d5e6a7b8c90",
    "phone": "0898765432",
    "tags": ["VIP", "Gold"]
  }'
js
const res = await fetch('https://public-api.smsup-plus.com/Person/updatePerson', {
  method: 'POST',
  headers: { Authorization: 'Bearer <API_KEY>', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    personId: '3f8b2c1e-7a4d-4e9b-9c2f-1d5e6a7b8c90',
    phone: '0898765432',
    tags: ['VIP', 'Gold'],
  }),
})
console.log(await res.json())

ตัวอย่าง Response ​

json
{
  "status": 200,
  "data": {
    "personId": "3f8b2c1e-7a4d-4e9b-9c2f-1d5e6a7b8c90",
    "accountId": 1024,
    "firstName": "สมชาย",
    "lastName": "ใจดี",
    "email": "somchai@example.com",
    "phone": "0898765432",
    "companyName": "Example Co., Ltd.",
    "note": "ลูกค้าสาขาสีลม",
    "tags": ["VIP", "Gold"],
    "isDeleted": false,
    "createdBy": 2048,
    "createdAt": "2026-11-16T03:15:42.123Z",
    "updatedAt": "2026-11-16T04:02:10.456789Z"
  }
}

Error ที่อาจเจอ ​

HTTPResponseสาเหตุ
200{"status":400,"description":"personId is required."}ไม่ได้ส่ง personId, body ไม่ใช่ JSON หรือชนิดข้อมูลผิด
200{"status":404,"description":"Person not found."}ไม่พบรายชื่อ ถูกลบไปแล้ว หรือไม่ใช่ของบัญชีคุณ
200{"status":500,"description":"Failed to query person."}ค้นหารายชื่อไม่สำเร็จ ลองใหม่อีกครั้ง
200{"status":500,"description":"Failed to update person."}บันทึกไม่สำเร็จ ลองใหม่อีกครั้ง
401{"error":"invalid api key"}API Key ไม่ถูกต้อง — ดู Error

WARNING

เมื่อผ่านการยืนยันตัวตนแล้ว endpoint นี้ตอบ HTTP 200 เสมอ ให้ตรวจผลจากฟิลด์ status ใน body

TIP

ฟิลด์ข้อความที่ส่งเป็นค่าว่าง "" จะถูกข้าม (คงค่าเดิม) จึงใช้ endpoint นี้ล้างค่าฟิลด์ข้อความไม่ได้ — ยกเว้น tags ที่ล้างได้ด้วย []