# HubSpot docs: APIs 2026-03 CRM Objects Contacts

## Contacts

- [Contacts API](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/guide.md): Contact records store information about individuals. The contacts endpoints allow you to manage this data and sync it between HubSpot and other systems.
- [Contact object definition](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/object-definition.md): Information about the Contact object, including identifiers, feature support, and default properties.
- [Create a contact](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/create-contact.md): Create a single contact. Include a `properties` object to define [property values](https://developers.hubspot.com/docs/guides/api/crm/properties) for the contact, along with an `associations` array to define [associations](https://developers.hubspot.com/docs/guides/api/crm/associations/associations-…
- [Retrieve a contact](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/get-contact.md): Retrieve a contact by its ID (`contactId`) or by a unique property (`idProperty`). You can specify what is returned using the `properties` query parameter.
- [Retrieve contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/get-contacts.md): Retrieve all contacts, using query parameters to specify the information that gets returned.
- [Merge two contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/merge-contacts.md): Merge two contact records. Learn more about [merging records](https://knowledge.hubspot.com/records/merge-records).
- [Update a contact](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/update-contact.md): Update an existing contact, identified by ID or email/unique property value. To identify a contact by ID, include the ID in the request URL path. To identify a contact by their email or other unique property, include the email/property value in the request URL path, and add the `idProperty` query pa…
- [Delete a contact](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/delete-contact.md): Delete a contact by ID. Deleted contacts can be restored within 90 days of deletion. Learn more about the [data impacted by contact deletions](https://knowledge.hubspot.com/privacy-and-consent/understand-restorable-and-permanent-contact-deletions) and how to [restore archived records](https://knowle…

### Batch

- [Create contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/batch/create-contacts.md): Create a batch of contacts. The `inputs` array can contain a `properties` object to define property values for each record, along with an `associations` array to define [associations](https://developers.hubspot.com/docs/guides/api/crm/associations/associations-v4) with other CRM records.
- [Retrieve contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/batch/get-contacts.md): Retrieve a batch of contacts by ID (`contactId`) or unique property value (`idProperty`).
- [Update contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/batch/update-contacts.md): Update a batch of contacts by ID (`contactId`) or unique property value (`idProperty`). Provided property values will be overwritten. Read-only and non-existent properties will result in an error. Properties values can be cleared by passing an empty string.
- [Upsert contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/batch/upsert-contacts.md): Upsert a batch of contacts. The `inputs` array can contain a `properties` object to define property values for each record.
- [Delete contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/batch/delete-contacts.md): Archive a batch of contacts by ID. Archived contacts can be restored within 90 days of deletion. Learn more about the [data impacted by contact deletions](https://knowledge.hubspot.com/privacy-and-consent/understand-restorable-and-permanent-contact-deletions) and how to [restore archived records](ht…

### Search

- [Search for contacts](https://developers.hubspot.com/docs/api-reference/2026-03/crm/objects/contacts/search/search-contacts.md): Search for contacts by filtering on properties, searching through associations, and sorting results. Learn more about [CRM search](https://developers.hubspot.com/docs/guides/api/crm/search#make-a-search-request).

## OpenAPI Specs

- [crm-contacts-v2026-03](/docs/specs/2026-03/crm-contacts-v2026-03.json)