curl -X PUT "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}'
import requests
url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"
payload = {
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Jane Doe-Smith",
tags: ["vip", "promoter"],
notes: "Upgraded to Enterprise tier"
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
{
"id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"phone_number": "+14155550199",
"name": "Jane Doe-Smith",
"tags": [
"vip",
"promoter"
],
"notes": "Upgraded to Enterprise tier",
"custom_fields": {
"company": "Acme Corp",
"lead_score": 92
},
"created_at": "2026-09-07T11:00:00Z",
"updated_at": "2026-09-07T14:40:00Z"
}
{
"detail": "Unauthorized"
}
{
"detail": "Contact not found"
}
Contacts
Update contact
Modify an existing contact’s details, tags, or custom metadata
PUT
/
api
/
v1
/
contacts
/
{contact_id}
curl -X PUT "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}'
import requests
url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"
payload = {
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Jane Doe-Smith",
tags: ["vip", "promoter"],
notes: "Upgraded to Enterprise tier"
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
{
"id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"phone_number": "+14155550199",
"name": "Jane Doe-Smith",
"tags": [
"vip",
"promoter"
],
"notes": "Upgraded to Enterprise tier",
"custom_fields": {
"company": "Acme Corp",
"lead_score": 92
},
"created_at": "2026-09-07T11:00:00Z",
"updated_at": "2026-09-07T14:40:00Z"
}
{
"detail": "Unauthorized"
}
{
"detail": "Contact not found"
}
Update profile fields, assign or replace segmentation tags, and edit custom key-value metadata on an existing contact record.
Authentication
This endpoint requires Bearer token authentication.Authorization: Bearer <token>
| Header | Type | Required | Description | Format |
|---|---|---|---|---|
Authorization | string | Yes | Scoped organization API key or Bearer JWT token | Bearer <token> |
Input parameters
string
required
Unique UUID identifier of the contact to update. Example:
7b8f9e2a-4c1d-48ef-9123-bcde456789ab.string
required
Bearer token for authentication. Format:
Bearer <token>.string
Updated full name of the contact.
string
Updated destination telephone number.
string[]
Updated array of segmentation tags (e.g.
["vip", "churn_risk"]).string
Updated internal notes.
object
Updated custom metadata attributes dictionary.
Response Fields
Returns the updated ContactResponse object:string
Contact UUID.
string
Organization UUID.
string
Updated telephone number.
string
Updated full name.
string[]
Updated segmentation tags.
string
Updated internal notes.
object
Updated metadata object.
string
Creation timestamp.
string
Modification timestamp.
curl -X PUT "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}'
import requests
url = "https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"
payload = {
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab", {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Jane Doe-Smith",
tags: ["vip", "promoter"],
notes: "Upgraded to Enterprise tier"
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sayvy.ai/api/v1/contacts/7b8f9e2a-4c1d-48ef-9123-bcde456789ab"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.PUT(HttpRequest.BodyPublishers.ofString("""
{
"name": "Jane Doe-Smith",
"tags": ["vip", "promoter"],
"notes": "Upgraded to Enterprise tier"
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
{
"id": "7b8f9e2a-4c1d-48ef-9123-bcde456789ab",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"phone_number": "+14155550199",
"name": "Jane Doe-Smith",
"tags": [
"vip",
"promoter"
],
"notes": "Upgraded to Enterprise tier",
"custom_fields": {
"company": "Acme Corp",
"lead_score": 92
},
"created_at": "2026-09-07T11:00:00Z",
"updated_at": "2026-09-07T14:40:00Z"
}
{
"detail": "Unauthorized"
}
{
"detail": "Contact not found"
}
‹ PreviousNext ›
Delete contact
DELETE /api/v1/contacts/{contact_id}
Was this page helpful?