Update Contact
Please find the list of acceptable values for the country field here
PUT
/
contacts
/
{contactId}
Update Contact
curl --request PUT \
--url https://services.leadconnectorhq.com/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Version: <version>' \
--data '
{
"firstName": "rosan",
"lastName": "Deo",
"name": "rosan Deo",
"email": "rosan@deos.com",
"phone": "+1 888-888-8888",
"address1": "3535 1st St N",
"city": "Dolomite",
"state": "AL",
"postalCode": "35061",
"website": "https://www.tesla.com",
"timezone": "America/Chihuahua",
"dnd": true,
"dndSettings": {},
"inboundDndSettings": {},
"tags": [
"nisi sint commodo amet",
"consequat"
],
"customFields": [
{
"id": "6dvNaf7VhkQ9snc5vnjJ",
"key": "my_custom_field",
"field_value": "My Text"
}
],
"source": "public api",
"dateOfBirth": "1990-09-25",
"country": "US",
"assignedTo": "y0BeYjuRIlDwsDcOHOJo"
}
'const options = {
method: 'PUT',
headers: {
Version: '<version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'rosan',
lastName: 'Deo',
name: 'rosan Deo',
email: 'rosan@deos.com',
phone: '+1 888-888-8888',
address1: '3535 1st St N',
city: 'Dolomite',
state: 'AL',
postalCode: '35061',
website: 'https://www.tesla.com',
timezone: 'America/Chihuahua',
dnd: true,
dndSettings: {},
inboundDndSettings: {},
tags: ['nisi sint commodo amet', 'consequat'],
customFields: [{id: '6dvNaf7VhkQ9snc5vnjJ', key: 'my_custom_field', field_value: 'My Text'}],
source: 'public api',
dateOfBirth: '1990-09-25',
country: 'US',
assignedTo: 'y0BeYjuRIlDwsDcOHOJo'
})
};
fetch('https://services.leadconnectorhq.com/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://services.leadconnectorhq.com/contacts/{contactId}"
payload = {
"firstName": "rosan",
"lastName": "Deo",
"name": "rosan Deo",
"email": "rosan@deos.com",
"phone": "+1 888-888-8888",
"address1": "3535 1st St N",
"city": "Dolomite",
"state": "AL",
"postalCode": "35061",
"website": "https://www.tesla.com",
"timezone": "America/Chihuahua",
"dnd": True,
"dndSettings": {},
"inboundDndSettings": {},
"tags": ["nisi sint commodo amet", "consequat"],
"customFields": [
{
"id": "6dvNaf7VhkQ9snc5vnjJ",
"key": "my_custom_field",
"field_value": "My Text"
}
],
"source": "public api",
"dateOfBirth": "1990-09-25",
"country": "US",
"assignedTo": "y0BeYjuRIlDwsDcOHOJo"
}
headers = {
"Version": "<version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"succeded": true,
"contact": {
"id": "seD4PfOuKoVMLkEZqohJ",
"name": "rubika deo",
"locationId": "ve9EPM428h8vShlRW1KT",
"firstName": "rubika",
"lastName": "Deo",
"email": "rubika@deos.com",
"emailLowerCase": "rubika@deos.com",
"timezone": "Asia/Calcutta",
"companyName": "DGS VolMAX",
"phone": "+18832327657",
"dnd": true,
"dndSettings": {
"Call": {
"message": "<string>",
"code": "<string>"
},
"Email": {
"message": "<string>",
"code": "<string>"
},
"SMS": {
"message": "<string>",
"code": "<string>"
},
"WhatsApp": {
"message": "<string>",
"code": "<string>"
},
"GMB": {
"message": "<string>",
"code": "<string>"
},
"FB": {
"message": "<string>",
"code": "<string>"
}
},
"type": "read",
"source": "public api",
"assignedTo": "ve9EPM428h8vShlRW1KT",
"address1": "3535 1st St N",
"city": "ruDolomitebika",
"state": "AL",
"country": "US",
"postalCode": "35061",
"website": "https://www.tesla.com",
"tags": [
"nisi sint commodo amet",
"consequat"
],
"dateOfBirth": "Date format YYYY-MM-DD",
"dateAdded": "2021-07-02T05:18:26.704Z",
"dateUpdated": "2021-07-02T05:18:26.704Z",
"attachments": "<string>",
"ssn": "<string>",
"keyword": "test",
"firstNameLowerCase": "rubika",
"fullNameLowerCase": "rubika deo",
"lastNameLowerCase": "deo",
"lastActivity": "2021-07-16T11:39:30.564Z",
"customFields": [
{
"id": "MgobCB14YMVKuE4Ka8p1",
"value": "name"
}
],
"businessId": "641c094001436dbc2081e642",
"attributionSource": {
"url": "Trigger Link",
"campaign": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmContent": "<string>",
"referrer": "https: //www.google.com",
"campaignId": "<string>",
"fbclid": "<string>",
"gclid": "CjOKCQjwnNyUBhCZARISAI9AYIFtNnIcWcYGIOQINz_ZoFI5SSLRRugSoPZoiEu27IZBY£1-MAIWmEaAo2VEALW_WCB",
"msclikid": "<string>",
"dclid": "<string>",
"fbc": "<string>",
"fbp": "fb. 1.1674748390986.1171287961",
"fbEventId": "Mozilla/5.0",
"userAgent": "Mozilla/5.0",
"ip": "58.111.106.198",
"medium": "survey",
"mediumId": "FglfHAn30PRwsZVyQlKp"
},
"lastAttributionSource": {
"url": "Trigger Link",
"campaign": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmContent": "<string>",
"referrer": "https: //www.google.com",
"campaignId": "<string>",
"fbclid": "<string>",
"gclid": "CjOKCQjwnNyUBhCZARISAI9AYIFtNnIcWcYGIOQINz_ZoFI5SSLRRugSoPZoiEu27IZBY£1-MAIWmEaAo2VEALW_WCB",
"msclikid": "<string>",
"dclid": "<string>",
"fbc": "<string>",
"fbp": "fb. 1.1674748390986.1171287961",
"fbEventId": "Mozilla/5.0",
"userAgent": "Mozilla/5.0",
"ip": "58.111.106.198",
"medium": "survey",
"mediumId": "FglfHAn30PRwsZVyQlKp"
},
"visitorId": "ve9EPM428h8vShlRW1KT"
}
}{
"statusCode": 400,
"message": "Bad Request"
}{
"statusCode": 401,
"message": "Invalid token: access token is invalid",
"error": "Unauthorized"
}{
"statusCode": 422,
"message": [
"Unprocessable Entity"
],
"error": "Unprocessable Entity"
}Authorizations
Use the Access Token generated with user type as Sub-Account (OR) Private Integration Token of Sub-Account.
Headers
API Version
Available options:
2021-07-28 Path Parameters
Contact Id
Example:
"ocQHyuzHvysMo5N5VsXc"
Body
application/json
Example:
"rosan"
Example:
"Deo"
Example:
"rosan Deo"
Example:
"rosan@deos.com"
Example:
"+1 888-888-8888"
Example:
"3535 1st St N"
Example:
"Dolomite"
Example:
"AL"
Example:
"35061"
Example:
"https://www.tesla.com"
Example:
"America/Chihuahua"
Example:
true
Show child attributes
Show child attributes
Show child attributes
Show child attributes
This field will overwrite all current tags associated with the contact. To update a tags, it is recommended to use the Add Tag or Remove Tag API instead.
Example:
["nisi sint commodo amet", "consequat"]
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
Show child attributes
Show child attributes
Example:
"public api"
The birth date of the contact. Supported formats: YYYY/MM/DD, MM/DD/YYYY, YYYY-MM-DD, MM-DD-YYYY, YYYY.MM.DD, MM.DD.YYYY, YYYY_MM_DD, MM_DD_YYYY
Example:
"1990-09-25"
Example:
"US"
User's Id
Example:
"y0BeYjuRIlDwsDcOHOJo"
Last modified on March 8, 2026
Was this page helpful?
⌘I
Update Contact
curl --request PUT \
--url https://services.leadconnectorhq.com/contacts/{contactId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Version: <version>' \
--data '
{
"firstName": "rosan",
"lastName": "Deo",
"name": "rosan Deo",
"email": "rosan@deos.com",
"phone": "+1 888-888-8888",
"address1": "3535 1st St N",
"city": "Dolomite",
"state": "AL",
"postalCode": "35061",
"website": "https://www.tesla.com",
"timezone": "America/Chihuahua",
"dnd": true,
"dndSettings": {},
"inboundDndSettings": {},
"tags": [
"nisi sint commodo amet",
"consequat"
],
"customFields": [
{
"id": "6dvNaf7VhkQ9snc5vnjJ",
"key": "my_custom_field",
"field_value": "My Text"
}
],
"source": "public api",
"dateOfBirth": "1990-09-25",
"country": "US",
"assignedTo": "y0BeYjuRIlDwsDcOHOJo"
}
'const options = {
method: 'PUT',
headers: {
Version: '<version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
firstName: 'rosan',
lastName: 'Deo',
name: 'rosan Deo',
email: 'rosan@deos.com',
phone: '+1 888-888-8888',
address1: '3535 1st St N',
city: 'Dolomite',
state: 'AL',
postalCode: '35061',
website: 'https://www.tesla.com',
timezone: 'America/Chihuahua',
dnd: true,
dndSettings: {},
inboundDndSettings: {},
tags: ['nisi sint commodo amet', 'consequat'],
customFields: [{id: '6dvNaf7VhkQ9snc5vnjJ', key: 'my_custom_field', field_value: 'My Text'}],
source: 'public api',
dateOfBirth: '1990-09-25',
country: 'US',
assignedTo: 'y0BeYjuRIlDwsDcOHOJo'
})
};
fetch('https://services.leadconnectorhq.com/contacts/{contactId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://services.leadconnectorhq.com/contacts/{contactId}"
payload = {
"firstName": "rosan",
"lastName": "Deo",
"name": "rosan Deo",
"email": "rosan@deos.com",
"phone": "+1 888-888-8888",
"address1": "3535 1st St N",
"city": "Dolomite",
"state": "AL",
"postalCode": "35061",
"website": "https://www.tesla.com",
"timezone": "America/Chihuahua",
"dnd": True,
"dndSettings": {},
"inboundDndSettings": {},
"tags": ["nisi sint commodo amet", "consequat"],
"customFields": [
{
"id": "6dvNaf7VhkQ9snc5vnjJ",
"key": "my_custom_field",
"field_value": "My Text"
}
],
"source": "public api",
"dateOfBirth": "1990-09-25",
"country": "US",
"assignedTo": "y0BeYjuRIlDwsDcOHOJo"
}
headers = {
"Version": "<version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text){
"succeded": true,
"contact": {
"id": "seD4PfOuKoVMLkEZqohJ",
"name": "rubika deo",
"locationId": "ve9EPM428h8vShlRW1KT",
"firstName": "rubika",
"lastName": "Deo",
"email": "rubika@deos.com",
"emailLowerCase": "rubika@deos.com",
"timezone": "Asia/Calcutta",
"companyName": "DGS VolMAX",
"phone": "+18832327657",
"dnd": true,
"dndSettings": {
"Call": {
"message": "<string>",
"code": "<string>"
},
"Email": {
"message": "<string>",
"code": "<string>"
},
"SMS": {
"message": "<string>",
"code": "<string>"
},
"WhatsApp": {
"message": "<string>",
"code": "<string>"
},
"GMB": {
"message": "<string>",
"code": "<string>"
},
"FB": {
"message": "<string>",
"code": "<string>"
}
},
"type": "read",
"source": "public api",
"assignedTo": "ve9EPM428h8vShlRW1KT",
"address1": "3535 1st St N",
"city": "ruDolomitebika",
"state": "AL",
"country": "US",
"postalCode": "35061",
"website": "https://www.tesla.com",
"tags": [
"nisi sint commodo amet",
"consequat"
],
"dateOfBirth": "Date format YYYY-MM-DD",
"dateAdded": "2021-07-02T05:18:26.704Z",
"dateUpdated": "2021-07-02T05:18:26.704Z",
"attachments": "<string>",
"ssn": "<string>",
"keyword": "test",
"firstNameLowerCase": "rubika",
"fullNameLowerCase": "rubika deo",
"lastNameLowerCase": "deo",
"lastActivity": "2021-07-16T11:39:30.564Z",
"customFields": [
{
"id": "MgobCB14YMVKuE4Ka8p1",
"value": "name"
}
],
"businessId": "641c094001436dbc2081e642",
"attributionSource": {
"url": "Trigger Link",
"campaign": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmContent": "<string>",
"referrer": "https: //www.google.com",
"campaignId": "<string>",
"fbclid": "<string>",
"gclid": "CjOKCQjwnNyUBhCZARISAI9AYIFtNnIcWcYGIOQINz_ZoFI5SSLRRugSoPZoiEu27IZBY£1-MAIWmEaAo2VEALW_WCB",
"msclikid": "<string>",
"dclid": "<string>",
"fbc": "<string>",
"fbp": "fb. 1.1674748390986.1171287961",
"fbEventId": "Mozilla/5.0",
"userAgent": "Mozilla/5.0",
"ip": "58.111.106.198",
"medium": "survey",
"mediumId": "FglfHAn30PRwsZVyQlKp"
},
"lastAttributionSource": {
"url": "Trigger Link",
"campaign": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmContent": "<string>",
"referrer": "https: //www.google.com",
"campaignId": "<string>",
"fbclid": "<string>",
"gclid": "CjOKCQjwnNyUBhCZARISAI9AYIFtNnIcWcYGIOQINz_ZoFI5SSLRRugSoPZoiEu27IZBY£1-MAIWmEaAo2VEALW_WCB",
"msclikid": "<string>",
"dclid": "<string>",
"fbc": "<string>",
"fbp": "fb. 1.1674748390986.1171287961",
"fbEventId": "Mozilla/5.0",
"userAgent": "Mozilla/5.0",
"ip": "58.111.106.198",
"medium": "survey",
"mediumId": "FglfHAn30PRwsZVyQlKp"
},
"visitorId": "ve9EPM428h8vShlRW1KT"
}
}{
"statusCode": 400,
"message": "Bad Request"
}{
"statusCode": 401,
"message": "Invalid token: access token is invalid",
"error": "Unauthorized"
}{
"statusCode": 422,
"message": [
"Unprocessable Entity"
],
"error": "Unprocessable Entity"
}