Zum Hauptinhalt springen
GET
/
crm
/
v3
/
objects
/
contacts
/
{contactId}
Einen Kontakt abrufen
curl --request GET \
  --url https://api.hubapi.com/crm/v3/objects/contacts/{contactId} \
  --header 'Authorization: Bearer <token>'
{
  "archived": true,
  "archivedAt": "2023-11-07T05:31:56Z",
  "associations": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "objectWriteTraceId": "<string>",
  "properties": {},
  "propertiesWithHistory": {},
  "updatedAt": "2023-11-07T05:31:56Z",
  "url": "<string>"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos
Diese API erfordert einen der folgenden Bereiche:
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
​
objectId
string
required

Die ID des Kontakts, der abgerufen werden soll.

​
objectType
string
required

Query Parameters

​
archived
boolean
default:false

Ob nur Ergebnisse zurückgegeben werden sollen, die archiviert wurden.

​
associations
string[]

Eine durch Kommas getrennte Liste der Objekttypen, für die zugeordnete IDs abgerufen werden sollen. Wenn angegebene Zuordnungen nicht existieren, werden sie ignoriert.

​
idProperty
string

Der Name einer Eigenschaft, deren Werte für dieses Objekt eindeutig sind.

​
properties
string[]

Eine durch Kommas getrennte Liste der Eigenschaften, die in der Antwort zurückgegeben werden sollen. Wenn angegebene Eigenschaften in dem oder den angeforderten Objekten nicht vorhanden sind, werden sie ignoriert.

​
propertiesWithHistory
string[]

Eine durch Kommas getrennte Liste der Eigenschaften, die zusammen mit den jeweiligen Verlaufswerten zurückgegeben werden sollen. Wenn Eigenschaften in dem oder den angeforderten Objekten nicht vorhanden sind, werden sie ignoriert.

Response

successful operation

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

​
archived
boolean
required

Whether the object is archived.

​
createdAt
string<date-time>
required

The timestamp when the object was created, in ISO 8601 format.

​
id
string
required

The unique ID of the object.

​
properties
object
required

Key value pairs representing the properties of the object.

​
updatedAt
string<date-time>
required

The timestamp when the object was last updated, in ISO 8601 format.

​
archivedAt
string<date-time>

The timestamp when the object was archived, in ISO 8601 format.

​
associations
object

A list defining relationships with other objects.

​
objectWriteTraceId
string
​
propertiesWithHistory
object

Key-value pairs representing the properties of the object along with their history.

​
url
string