curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact/vid/{vid}/profile{
"properties": [
{
"property": "email",
"value": "new-email@hubspot.com"
},
{
"property": "firstname",
"value": "Updated"
},
{
"property": "lastname",
"value": "Record"
},
{
"property": "website",
"value": ""
},
{
"property": "lifecyclestage",
"value": "customer"
}
]
}Update a contact by vid
This endpoint is used to update an existing contact in HubSpot by its vid (visitor ID). It only updates the properties specified in the request. Use case for this endpoint: Let’s say you’ve been updating contact records in an external database and now you want to sync those updates to HubSpot. You can use this endpoint to complete the sync and avoid making manual updates.
curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact/vid/{vid}/profile{
"properties": [
{
"property": "email",
"value": "new-email@hubspot.com"
},
{
"property": "firstname",
"value": "Updated"
},
{
"property": "lastname",
"value": "Record"
},
{
"property": "website",
"value": ""
},
{
"property": "lifecyclestage",
"value": "customer"
}
]
}Scope requirements
Scope requirements
Query Parameters
Each vid requires it's own query parameter (vid=10&vid=11). Requests should be limited to 100 or fewer vids. Any vids that are provided that are invalid will be ignored.
Specify the properties that should be returned for each ID. By default, the endpoint returns all valued properties for a contact. If this parameter is used, only the specified property or properties will be included.
One of value_only or value_and_history to specify if the current value for a property should be fetched, or the value and all the historical values for that property. Default is value_only.
One of all, none, newest, oldest to specify which form submissions should be fetched. Default is newest.
Boolean true or false to indicate whether current list memberships should be fetched for the contact. Default is false.
Boolean true or false to indicate whether the return of deleted contacts is desired. Default is false.
Response
Successful response - For a given account, return information about a group of contacts by their unique IDs
The response is of type object.
Was this page helpful?