Update a contact list
PUT
/v1/accounts/{accountId}/contactLists/{contactListId}Renames a contact list. To change its numbers, use Add numbers and Delete numbers.
Path parameters
accountIduuidRequired
ID of your SIP Caller account. See Account ID.
contactListIduuidRequired
ID of the contact list.
Request body
namestringRequired
Name of the contact list, between 2 and 99 characters. It must be unique in the account.
lastUpdatedAttimestampRequired
The updatedAt value of the contact list, as returned the last time you retrieved, created or updated it. If the contact list was modified in the meantime, the request fails with 412 Precondition Failed. See Concurrent updates.
Returns
Returns the updated contact list object.
PUT
/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID
cURL
curl -X PUT 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"name": "Overdue Accounts - October",
"lastUpdatedAt": "2026-08-13T18:03:28.729"
}'Response
200 OK
{
"id": "019ffc4b-1c59-72ed-b15a-cbf81a2b95d9",
"name": "Overdue Accounts - October",
"numbersCount": 1255,
"varNames": [
"Customer Name",
"Due Balance"
],
"updatedAt": "2026-09-26T19:05:15.123"
}
