Update Contact POST
Updates an existing contact. Send only the fields you want to change; fields you leave out keep their current value.
Authorization
API Key (Authentication) — send the header Authorization: Bearer <API_KEY> (API keys start with smsk_)
HTTP Request
http
POST https://public-api.smsup-plus.com/Person/updatePersonContent Type
application/json
Parameter Description
| Property | Type | Required | Description |
|---|---|---|---|
personId | string | Required | ID of the contact to update (must belong to your account) |
firstName | string | Optional | New first name |
lastName | string | Optional | New last name |
email | string | Optional | New email |
phone | string | Optional | New phone number |
companyName | string | Optional | New company name |
note | string | Optional | New note |
tags | string[] | Optional | New tags — replaces the whole list. Send [] to clear all tags; omit (or send null) to keep the current list |
Response Description
| Property | Type | Description |
|---|---|---|
status | number | 200 on success |
data | object | The contact after the update — same fields as Person |
Request Example
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 Example
json
{
"status": 200,
"data": {
"personId": "3f8b2c1e-7a4d-4e9b-9c2f-1d5e6a7b8c90",
"accountId": 1024,
"firstName": "Somchai",
"lastName": "Jaidee",
"email": "somchai@example.com",
"phone": "0898765432",
"companyName": "Example Co., Ltd.",
"note": "Silom branch customer",
"tags": ["VIP", "Gold"],
"isDeleted": false,
"createdBy": 2048,
"createdAt": "2026-11-16T03:15:42.123Z",
"updatedAt": "2026-11-16T04:02:10.456789Z"
}
}Possible Errors
| HTTP | Response | Cause |
|---|---|---|
| 200 | {"status":400,"description":"personId is required."} | personId missing, body is not JSON, or a field has the wrong type |
| 200 | {"status":404,"description":"Person not found."} | Contact does not exist, was deleted, or belongs to another account |
| 200 | {"status":500,"description":"Failed to query person."} | Contact lookup failed — retry |
| 200 | {"status":500,"description":"Failed to update person."} | Save failed — retry |
| 401 | {"error":"invalid api key"} | Invalid API key — see Errors |
WARNING
Once authenticated, this endpoint always answers HTTP 200. Check the status field in the body.
TIP
Text fields sent as an empty string "" are ignored (the current value is kept), so this endpoint cannot clear a text field — only tags can be cleared, with [].
