curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact \
--header 'Content-Type: application/json' \
--data '{
"properties": [
{
"property": "<string>",
"value": "<string>"
}
]
}'
"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/\n\nExample POST body:\nThe code sample below represents some example JSON with \nstandard fields to pass in the body of your request in \norder to create a new contact:\n{\n \"properties\": [\n {\n \"property\": \"email\",\n \"value\": \"testingapis@hubspot.com\"\n },\n {\n \"property\": \"firstname\",\n \"value\": \"Adrian\"\n },\n {\n \"property\": \"lastname\",\n \"value\": \"Mott\"\n },\n {\n \"property\": \"website\",\n \"value\": \"http://hubspot.com\"\n },\n {\n \"property\": \"company\",\n \"value\": \"HubSpot\"\n },\n {\n \"property\": \"phone\",\n \"value\": \"555-122-2323\"\n },\n {\n \"property\": \"address\",\n \"value\": \"25 First Street\"\n },\n {\n \"property\": \"city\",\n \"value\": \"Cambridge\"\n },\n {\n \"property\": \"state\",\n \"value\": \"MA\"\n },\n {\n \"property\": \"zip\",\n \"value\": \"02139\"\n }\n ]\n}\n \nReturns an HTTP 200 response on success, with the response body containing the details of the new contact record:\n{\n \"identity-profiles\": [\n {\n \"identities\": [\n {\n \"timestamp\": 1331075050646,\n \"type\": \"EMAIL\",\n \"value\": \"fumanchu@hubspot.com\"\n },\n {\n \"timestamp\": 1331075050681,\n \"type\": \"LEAD_GUID\",\n \"value\": \"22a26060-c9d7-44b0-9f07-aa40488cfa3a\"\n }\n ],\n \"vid\": 61574\n }\n ],\n \"properties\": {\n \"website\": {\n \"value\": \"http: //hubspot.com\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"http: //hubspot.com\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"city\": {\n \"value\": \"Cambridge\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Cambridge\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"firstname\": {\n \"value\": \"Adrian\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Adrian\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"zip\": {\n \"value\": \"02139\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"02139\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"lastname\": {\n \"value\": \"Mott\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Mott\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"company\": {\n \"value\": \"HubSpot\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"HubSpot\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"phone\": {\n \"value\": \"555-122-2323\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"555-122-2323\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"state\": {\n \"value\": \"MA\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"MA\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"address\": {\n \"value\": \"25FirstStreet\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"25FirstStreet\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"email\": {\n \"value\": \"fumanchu@hubspot.com\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"fumanchu@hubspot.com\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n }\n },\n \"form-submissions\": [\n ],\n \"vid\": 61574\n}"
The create a new contact endpoint is used to create a new contact in HubSpot. The new contact will be assigned a unique ID (vid), which can be used to look it up later. Use case for this endpoint: This endpoint can be used to perform a one-time sync of new contacts from an external system into HubSpot. Need to create or update multiple contacts? Try the Batch endpoint. Note: This endpoint is designed for offline contacts and does not support lead tracking. If your contacts come through online forms, use the form submission endpoint.
curl --request POST \
--url https://api.hubapi.com/contacts/v1/contact \
--header 'Content-Type: application/json' \
--data '{
"properties": [
{
"property": "<string>",
"value": "<string>"
}
]
}'
"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/\n\nExample POST body:\nThe code sample below represents some example JSON with \nstandard fields to pass in the body of your request in \norder to create a new contact:\n{\n \"properties\": [\n {\n \"property\": \"email\",\n \"value\": \"testingapis@hubspot.com\"\n },\n {\n \"property\": \"firstname\",\n \"value\": \"Adrian\"\n },\n {\n \"property\": \"lastname\",\n \"value\": \"Mott\"\n },\n {\n \"property\": \"website\",\n \"value\": \"http://hubspot.com\"\n },\n {\n \"property\": \"company\",\n \"value\": \"HubSpot\"\n },\n {\n \"property\": \"phone\",\n \"value\": \"555-122-2323\"\n },\n {\n \"property\": \"address\",\n \"value\": \"25 First Street\"\n },\n {\n \"property\": \"city\",\n \"value\": \"Cambridge\"\n },\n {\n \"property\": \"state\",\n \"value\": \"MA\"\n },\n {\n \"property\": \"zip\",\n \"value\": \"02139\"\n }\n ]\n}\n \nReturns an HTTP 200 response on success, with the response body containing the details of the new contact record:\n{\n \"identity-profiles\": [\n {\n \"identities\": [\n {\n \"timestamp\": 1331075050646,\n \"type\": \"EMAIL\",\n \"value\": \"fumanchu@hubspot.com\"\n },\n {\n \"timestamp\": 1331075050681,\n \"type\": \"LEAD_GUID\",\n \"value\": \"22a26060-c9d7-44b0-9f07-aa40488cfa3a\"\n }\n ],\n \"vid\": 61574\n }\n ],\n \"properties\": {\n \"website\": {\n \"value\": \"http: //hubspot.com\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"http: //hubspot.com\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"city\": {\n \"value\": \"Cambridge\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Cambridge\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"firstname\": {\n \"value\": \"Adrian\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Adrian\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"zip\": {\n \"value\": \"02139\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"02139\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"lastname\": {\n \"value\": \"Mott\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"Mott\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"company\": {\n \"value\": \"HubSpot\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"HubSpot\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"phone\": {\n \"value\": \"555-122-2323\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"555-122-2323\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"state\": {\n \"value\": \"MA\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"MA\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"address\": {\n \"value\": \"25FirstStreet\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"25FirstStreet\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n },\n \"email\": {\n \"value\": \"fumanchu@hubspot.com\",\n \"versions\": [\n {\n \"timestamp\": 1331075050646,\n \"selected\": false,\n \"source-label\": null,\n \"value\": \"fumanchu@hubspot.com\",\n \"source-type\": \"API\",\n \"source-id\": null\n }\n ]\n }\n },\n \"form-submissions\": [\n ],\n \"vid\": 61574\n}"
The VID of the specific contact you want to update.
Successful response - This endpoint is used to update an existing contact in HubSpot
The response is of type object
.