POST
/
contacts
/
v1
/
contact
/
vid
/
{vid}
/
profile
Update a contact by vid
curl --request POST \
  --url https://api.hubapi.com/contacts/v1/contact/vid/{vid}/profile
"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/vid/2340324/profile\n\nExample POST body:\n{\n  \"properties\": [\n    {\n      \"property\": \"email\",\n      \"value\": \"new-email@hubspot.com\"\n    },\n    {\n      \"property\": \"firstname\",\n      \"value\": \"Updated\"\n    },\n    {\n      \"property\": \"lastname\",\n      \"value\": \"Record\"\n    },\n    {\n      \"property\": \"website\",\n      \"value\": \"http://updated.example.com\"\n    },\n    {\n      \"property\": \"lifecyclestage\",\n      \"value\": \"customer\"\n    }\n  ]\n}\n\nReturns a 204 No Content response on success."

Query Parameters

​
vid
string
required

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.

​
property
string

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.

​
propertyMode
string

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.

​
formSubmissionMode
string

One of all, none, newest, oldest to specify which form submissions should be fetched. Default is newest.

​
showListMemberships
string

Boolean true or false to indicate whether current list memberships should be fetched for the contact. Default is false.

​
includeDeletes
string

Boolean true or false to indicate whether the return of deleted contacts is desired. Default is false.

Response

200 - application/json

Successful response - For a given account, return information about a group of contacts by their unique IDs

The response is of type object.