POST
/
contacts
/
v1
/
contact
Create a new contact
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}"

Path Parameters

vid
string
required

The VID of the specific contact you want to update.

Body

application/json

Response

200 - application/json

Successful response - This endpoint is used to update an existing contact in HubSpot

The response is of type object.