Update a contact
curl --request PATCH \
--url https://api.tented.ai/v1/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>",
"phone": "<string>",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": true,
"marketing_email_subscribed": true,
"marketing_sms_subscribed": true,
"marketing_sms_invalid": true,
"custom_fields": {}
}
'import requests
url = "https://api.tented.ai/v1/contacts/{contactId}"
payload = {
"email": "<string>",
"phone": "<string>",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": True,
"marketing_email_subscribed": True,
"marketing_sms_subscribed": True,
"marketing_sms_invalid": True,
"custom_fields": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: '<string>',
phone: '<string>',
display_name: '<string>',
first_name: '<string>',
last_name: '<string>',
email_domain: '<string>',
company: '<string>',
job_title: '<string>',
address: '<string>',
address2: '<string>',
city: '<string>',
state: '<string>',
country: '<string>',
zip_code: '<string>',
original_source: '<string>',
original_source_detail: '<string>',
lead_status: '<string>',
lifecycle_stage: '<string>',
tented_score: 123,
unsubscribed: true,
marketing_email_subscribed: true,
marketing_sms_subscribed: true,
marketing_sms_invalid: true,
custom_fields: {}
})
};
fetch('https://api.tented.ai/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tented.ai/v1/contacts/{contactId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'email' => '<string>',
'phone' => '<string>',
'display_name' => '<string>',
'first_name' => '<string>',
'last_name' => '<string>',
'email_domain' => '<string>',
'company' => '<string>',
'job_title' => '<string>',
'address' => '<string>',
'address2' => '<string>',
'city' => '<string>',
'state' => '<string>',
'country' => '<string>',
'zip_code' => '<string>',
'original_source' => '<string>',
'original_source_detail' => '<string>',
'lead_status' => '<string>',
'lifecycle_stage' => '<string>',
'tented_score' => 123,
'unsubscribed' => true,
'marketing_email_subscribed' => true,
'marketing_sms_subscribed' => true,
'marketing_sms_invalid' => true,
'custom_fields' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tented.ai/v1/contacts/{contactId}"
payload := strings.NewReader("{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.tented.ai/v1/contacts/{contactId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tented.ai/v1/contacts/{contactId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}"
response = http.request(request)
puts response.read_body{
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"phone": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": true,
"marketing_email_subscribed": true,
"marketing_sms_subscribed": true,
"marketing_email_invalid": true,
"marketing_sms_invalid": true,
"last_activity_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {}
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}Contacts
Update a contact
Update a single contact by ID — the single-record equivalent of one POST /v1/contacts/update item, without the batch envelope. Only the fields present in the body are changed; nullable fields accept null to clear the stored value; unknown fields are rejected. A body with no updatable fields returns 400 (No fields to update). Changing email or phone to a value already used by another contact returns 409 with the conflicting contact in details.existing_contact, and clearing both identifiers is rejected — a contact must always keep at least one valid email or phone. Returns the full updated contact, including custom_fields.
PATCH
/
v1
/
contacts
/
{contactId}
Update a contact
curl --request PATCH \
--url https://api.tented.ai/v1/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "<string>",
"phone": "<string>",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": true,
"marketing_email_subscribed": true,
"marketing_sms_subscribed": true,
"marketing_sms_invalid": true,
"custom_fields": {}
}
'import requests
url = "https://api.tented.ai/v1/contacts/{contactId}"
payload = {
"email": "<string>",
"phone": "<string>",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": True,
"marketing_email_subscribed": True,
"marketing_sms_subscribed": True,
"marketing_sms_invalid": True,
"custom_fields": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: '<string>',
phone: '<string>',
display_name: '<string>',
first_name: '<string>',
last_name: '<string>',
email_domain: '<string>',
company: '<string>',
job_title: '<string>',
address: '<string>',
address2: '<string>',
city: '<string>',
state: '<string>',
country: '<string>',
zip_code: '<string>',
original_source: '<string>',
original_source_detail: '<string>',
lead_status: '<string>',
lifecycle_stage: '<string>',
tented_score: 123,
unsubscribed: true,
marketing_email_subscribed: true,
marketing_sms_subscribed: true,
marketing_sms_invalid: true,
custom_fields: {}
})
};
fetch('https://api.tented.ai/v1/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tented.ai/v1/contacts/{contactId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'email' => '<string>',
'phone' => '<string>',
'display_name' => '<string>',
'first_name' => '<string>',
'last_name' => '<string>',
'email_domain' => '<string>',
'company' => '<string>',
'job_title' => '<string>',
'address' => '<string>',
'address2' => '<string>',
'city' => '<string>',
'state' => '<string>',
'country' => '<string>',
'zip_code' => '<string>',
'original_source' => '<string>',
'original_source_detail' => '<string>',
'lead_status' => '<string>',
'lifecycle_stage' => '<string>',
'tented_score' => 123,
'unsubscribed' => true,
'marketing_email_subscribed' => true,
'marketing_sms_subscribed' => true,
'marketing_sms_invalid' => true,
'custom_fields' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tented.ai/v1/contacts/{contactId}"
payload := strings.NewReader("{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.tented.ai/v1/contacts/{contactId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tented.ai/v1/contacts/{contactId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"display_name\": \"<string>\",\n \"first_name\": \"<string>\",\n \"last_name\": \"<string>\",\n \"email_domain\": \"<string>\",\n \"company\": \"<string>\",\n \"job_title\": \"<string>\",\n \"address\": \"<string>\",\n \"address2\": \"<string>\",\n \"city\": \"<string>\",\n \"state\": \"<string>\",\n \"country\": \"<string>\",\n \"zip_code\": \"<string>\",\n \"original_source\": \"<string>\",\n \"original_source_detail\": \"<string>\",\n \"lead_status\": \"<string>\",\n \"lifecycle_stage\": \"<string>\",\n \"tented_score\": 123,\n \"unsubscribed\": true,\n \"marketing_email_subscribed\": true,\n \"marketing_sms_subscribed\": true,\n \"marketing_sms_invalid\": true,\n \"custom_fields\": {}\n}"
response = http.request(request)
puts response.read_body{
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"phone": "<string>",
"email_domain": "<string>",
"company": "<string>",
"job_title": "<string>",
"address": "<string>",
"address2": "<string>",
"city": "<string>",
"state": "<string>",
"country": "<string>",
"zip_code": "<string>",
"original_source": "<string>",
"original_source_detail": "<string>",
"lead_status": "<string>",
"lifecycle_stage": "<string>",
"tented_score": 123,
"unsubscribed": true,
"marketing_email_subscribed": true,
"marketing_sms_subscribed": true,
"marketing_email_invalid": true,
"marketing_sms_invalid": true,
"last_activity_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"custom_fields": {}
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}{
"error": "<string>",
"error_code": "<string>",
"message": "<string>",
"code": "<string>",
"details": {},
"limit": 123,
"current": 123
}Authorizations
Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.
Path Parameters
Contact ID.
Body
application/json
Fields to change on a contact. Only supplied fields are modified; unknown fields are rejected. A contact must always keep at least one of email or phone.
Email address. Pass null to clear (only allowed if a valid phone remains).
Phone number. Pass null to clear (only allowed if a valid email remains).
Display name. Pass null to clear.
Maximum string length:
255First name. Pass null to clear.
Maximum string length:
255Last name. Pass null to clear.
Maximum string length:
255Usually auto-derived from email.
Maximum string length:
255Company. Pass null to clear.
Maximum string length:
255Job title. Pass null to clear.
Maximum string length:
255Street address. Pass null to clear.
Maximum string length:
500Address line 2. Pass null to clear.
Maximum string length:
255City. Pass null to clear.
Maximum string length:
255State or region. Pass null to clear.
Maximum string length:
255Country. Pass null to clear.
Maximum string length:
255Postal code. Pass null to clear.
Maximum string length:
50Original source. Pass null to clear.
Maximum string length:
255Original source detail. Pass null to clear.
Maximum string length:
255Lead status. Pass null to clear.
Maximum string length:
100Lifecycle stage. Pass null to clear.
Maximum string length:
100Contact score. Pass null to clear.
Global unsubscribe flag.
Email marketing subscription state.
SMS marketing subscription state.
Mark the phone number invalid.
Editable custom fields keyed by API name. Pass null to clear a value.
Show child attributes
Show child attributes
Response
The updated contact, including custom_fields.
A contact record including its custom field values.
Contact ID.
Display name.
First name.
Last name.
Email address.
Phone number.
Domain derived from the email address.
Company.
Job title.
Street address.
Address line 2.
City.
State or region.
Country.
Postal code.
How the contact was first created, e.g. Public API.
Additional source detail.
Lead status.
Lifecycle stage.
Contact score.
Global unsubscribe flag.
Email marketing subscription state.
SMS marketing subscription state.
Whether the email address is known to be invalid.
Whether the phone number is known to be invalid.
Most recent tracked activity.
Creation time.
Last update.
Custom field values keyed by field API name. Values are returned as stored strings (or null) regardless of the field's declared value type.
Show child attributes
Show child attributes