Skip to content

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/updatePerson

Content Type ​

application/json

Parameter Description ​

PropertyTypeRequiredDescription
personIdstringRequiredID of the contact to update (must belong to your account)
firstNamestringOptionalNew first name
lastNamestringOptionalNew last name
emailstringOptionalNew email
phonestringOptionalNew phone number
companyNamestringOptionalNew company name
notestringOptionalNew note
tagsstring[]OptionalNew tags — replaces the whole list. Send [] to clear all tags; omit (or send null) to keep the current list

Response Description ​

PropertyTypeDescription
statusnumber200 on success
dataobjectThe 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 ​

HTTPResponseCause
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 [].