GET
/
crm
/
v3
/
objects
/
contacts
/
{contactId}
Recuperar un contacto
curl --request GET \
  --url https://api.hubapi.com/crm/v3/objects/contacts/{contactId} \
  --header 'Authorization: Bearer <token>'
{
  "associations": "{\"companies\":{\"results\":[{\"id\":\"29846388244\",\"type\":\"contact_to_company\"},{\"id\":\"29846388244\",\"type\":\"contact_to_company_unlabeled\"}]}}",
  "createdAt": "2023-11-07T05:31:56Z",
  "archived": true,
  "archivedAt": "2023-11-07T05:31:56Z",
  "propertiesWithHistory": "{\"lastname\":[{\"value\":\"Scout\",\"sourceId\":\"userId:2931299\",\"timestamp\":\"2025-02-11T16:28:13.591Z\",\"sourceType\":\"CRM_UI\",\"updatedByUserId\":2931299},{\"value\":\"S.\",\"sourceId\":\"userId:2931299\",\"timestamp\":\"2025-02-11T15:45:00.400Z\",\"sourceType\":\"CRM_UI\",\"updatedByUserId\":2931299}]}",
  "id": "<string>",
  "objectWriteTraceId": "<string>",
  "properties": "{\"email\":\"mark.s@lumon.industries\",\"lastname\":\"S.\",\"firstname\":\"Mark\",\"createdate\":\"2025-02-11T15:45:00.400Z\",\"hs_object_id\":\"98630638716\",\"lastmodifieddate\":\"2025-02-11T15:52:10.273Z\"}",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubGratuito

​
Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • crm.objects.contacts.read

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
contactId
string
required

The ID of the contact to retrieve.

Query Parameters

​
properties
string[]

Una lista separada por comas de las propiedades que se devolverán en la respuesta. Si alguna de las propiedades especificadas no está presente en los objetos solicitados, se ignorará.

​
propertiesWithHistory
string[]

Una lista separada por comas de las propiedades que se devolverán junto con su historial de valores anteriores. Si alguna de las propiedades especificadas no está presente en los objetos solicitados, se ignorará.

​
associations
string[]

Una lista separada por comas de los tipos de objetos para los que se desea recuperar los ID asociados. Si alguna de las asociaciones especificadas no existe, se ignorará.

​
archived
boolean
default:false

Si se quieren devolver solo los resultados que se han archivado.

Response

200
application/json

successful operation

Represents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type.