Zum Hauptinhalt springen
POST
/
crm-object-schemas
/
v3
/
schemas
Erstellen Sie ein neues benutzerdefiniertes Objektschema.
curl --request POST \
  --url https://api.hubapi.com/crm-object-schemas/v3/schemas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associatedObjects": [
    "CONTACT"
  ],
  "labels": {
    "plural": "My objects",
    "singular": "My object"
  },
  "metaType": "PORTAL_SPECIFIC",
  "name": "my_object",
  "primaryDisplayProperty": "my_object_property",
  "properties": [
    {
      "isPrimaryDisplayLabel": true,
      "label": "My object property",
      "name": "my_object_property"
    }
  ],
  "requiredProperties": [
    "my_object_property"
  ]
}
'
{
  "associations": [
    {
      "fromObjectTypeId": "2-123456",
      "id": "123",
      "name": "my_object_to_contact",
      "toObjectTypeId": "0-1"
    }
  ],
  "createdAt": "2020-02-20T18:07:11.390Z",
  "fullyQualifiedName": "p7878787_my_object\"",
  "id": "123456",
  "labels": {
    "plural": "My objects",
    "singular": "My object"
  },
  "metaType": "PORTAL_SPECIFIC",
  "name": "my_object",
  "primaryDisplayProperty": "my_object_property",
  "properties": [
    {
      "archived": false,
      "calculated": false,
      "createdAt": "2020-02-20T18:07:11.802Z",
      "displayOrder": -1,
      "externalOptions": false,
      "fieldType": "text",
      "groupName": "my_object_information",
      "hasUniqueValue": false,
      "label": "My object property",
      "name": "my_object_property",
      "type": "string",
      "updatedAt": "2020-02-20T18:07:11.802Z"
    }
  ],
  "requiredProperties": [
    "my_object_property"
  ],
  "searchableProperties": [
    "my_object_property"
  ],
  "updatedAt": "2020-02-20T18:09:07.555Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt

Use this file to discover all available pages before exploring further.

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json

Object schema definition, including properties and associations.

Defines a new object type, its properties, and associations.

associatedObjects
string[]
erforderlich

Für diesen Objekttyp definierte Zuordnungen.

labels
object
erforderlich

Singular and plural labels for the object. Used in CRM display.

Beispiel:
{
"plural": "My objects",
"singular": "My object"
}
name
string
erforderlich

Ein eindeutiger Name für dieses Objekt. Nur zur internen Verwendung.

properties
object[]
erforderlich

Für diesen Objekttyp definierte Eigenschaften.

requiredProperties
string[]
erforderlich

Die Namen der erforderlichen Eigenschaften beim Erstellen eines Objekts dieses Typs.

allowsSensitiveProperties
boolean

Legt fest, ob der Objekttyp Eigenschaften enthalten kann, die als vertraulich markiert sind.

description
string

Eine kurze Erläuterung des Objekttyps.

primaryDisplayProperty
string

Der Name der primären Eigenschaft für dieses Objekt. Diese wird auf der HubSpot-Datensatzseite für diesen Objekttyp als primär angezeigt.

searchableProperties
string[]

Namen von Eigenschaften, die für diesen Objekttyp in HubSpots Produktsuche indexiert werden.

secondaryDisplayProperties
string[]

Die Namen der sekundären Eigenschaften für dieses Objekt. Diese werden auf der HubSpot-Datensatzseite für diesen Objekttyp als sekundär angezeigt.

Antwort

successful operation

Defines an object schema, including its properties and associations.

associations
object[]
erforderlich

Für einen angegebenen Objekttyp definierte Zuordnungen.

id
string
erforderlich

Eine eindeutige ID für den Objekttyp dieses Schemas. Wird definiert als {meta-type}-{unique ID}.

labels
object
erforderlich

Singular and plural labels for the object. Used in CRM display.

Beispiel:
{
"plural": "My objects",
"singular": "My object"
}
name
string
erforderlich

Ein eindeutiger Name für den Objekttyp des Schemas.

properties
object[]
erforderlich

Für diesen Objekttyp definierte Eigenschaften.

requiredProperties
string[]
erforderlich

Die Namen der erforderlichen Eigenschaften beim Erstellen eines Objekts dieses Typs.

allowsSensitiveProperties
boolean
archived
boolean
createdAt
string<date-time>

Wann das Objektschema erstellt wurde.

createdByUserId
integer<int32>
description
string
fullyQualifiedName
string

Eine zugewiesene eindeutige ID für das Objekt, einschließlich Portal-ID und Objektname.

objectTypeId
string
primaryDisplayProperty
string

Der Name der primären Eigenschaft für dieses Objekt. Diese wird auf der HubSpot-Datensatzseite für diesen Objekttyp als primär angezeigt.

searchableProperties
string[]

Namen von Eigenschaften, die für diesen Objekttyp in HubSpots Produktsuche indexiert werden.

secondaryDisplayProperties
string[]

Die Namen der sekundären Eigenschaften für dieses Objekt. Diese werden auf der HubSpot-Datensatzseite für diesen Objekttyp als sekundär angezeigt.

updatedAt
string<date-time>

Wann das Objektschema zuletzt aktualisiert wurde.

updatedByUserId
integer<int32>
Last modified on April 13, 2026