DELETE
/
contacts
/
v1
/
contact
/
batch
/
Create or update a group of contacts
curl --request DELETE \
  --url https://api.hubapi.com/contacts/v1/contact/batch/ \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "vid": "<string>",
    "email": "<string>",
    "properties": [
      {
        "property": "<string>",
        "value": "<string>"
      }
    ]
  }
]'
"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/batch/\n\nExample POST body:\nThis includes updates to some standard properties for two contacts,\none existing contact identified by the contact vid, and another contact\nthat may or may not exist, identified by email:\n[\n  {\n    \"vid\": \"259429\",\n    \"properties\": [\n      {\n        \"property\": \"firstname\",\n        \"value\": \"Harper\"\n      },\n      {\n        \"property\": \"lastname\",\n        \"value\": \"Wolfberg\"\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  {\n    \"email\": \"testingapis@hubspot.com\",\n    \"properties\": [\n      {\n        \"property\": \"firstname\",\n        \"value\": \"Codey\"\n      },\n      {\n        \"property\": \"lastname\",\n        \"value\": \"Huang\"\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]\n\nReturns a 202 Accepted response with no content on success."

Query Parameters

​
auditId
string

A string that allows you to represent these change sources however you'd like.

Body

application/json · object[]

List of contacts to create or update.

Response

200 - application/json

Successful response - This endpoint is used to create a group of contacts or update existing ones

The response is of type object.