Saltar al contenido principal
PATCH
/
crm-object-schemas
/
2026-03
/
schemas
/
{objectType}
Actualizar el esquema de un objeto personalizado específico.
curl --request PATCH \
  --url https://api.hubapi.com/crm-object-schemas/2026-03/schemas/{objectType} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clearDescription": true,
  "allowsSensitiveProperties": true,
  "description": "<string>",
  "labels": {
    "plural": "<string>",
    "singular": "<string>"
  },
  "primaryDisplayProperty": "<string>",
  "requiredProperties": [
    "<string>"
  ],
  "restorable": true,
  "searchableProperties": [
    "<string>"
  ],
  "secondaryDisplayProperties": [
    "<string>"
  ]
}
'
{
  "allowsSensitiveProperties": true,
  "archived": true,
  "fullyQualifiedName": "<string>",
  "id": "<string>",
  "labels": {
    "plural": "<string>",
    "singular": "<string>"
  },
  "name": "<string>",
  "objectTypeId": "<string>",
  "requiredProperties": [
    "<string>"
  ],
  "searchableProperties": [
    "<string>"
  ],
  "secondaryDisplayProperties": [
    "<string>"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "portalId": 123,
  "primaryDisplayProperty": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Supported products

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

objectType
string
requerido

Nombre completamente calificado o ID del tipo de objeto de tu esquema.

Cuerpo

application/json
clearDescription
boolean
requerido

Indica si se debe borrar la descripción del tipo de objeto.

allowsSensitiveProperties
boolean

Determina si el tipo de objeto puede incluir propiedades marcadas como sensibles.

description
string

Una breve explicación del tipo de objeto.

labels
object
primaryDisplayProperty
string

El nombre de la propiedad principal de este objeto. Se mostrará como principal en la página de registro de HubSpot para este tipo de objeto.

requiredProperties
string[]

Los nombres de las propiedades que deben ser obligatorias cuando se cree un objeto de este tipo.

restorable
boolean

Especifica si el tipo de objeto se puede restaurar después de eliminarse.

searchableProperties
string[]

Los nombres de las propiedades que serán indexadas para este tipo de objeto en la búsqueda de productos de HubSpot.

secondaryDisplayProperties
string[]

Los nombres de las propiedades secundarias de este objeto. Se mostrarán como secundarias en la página de registro de HubSpot para este tipo de objeto.

Respuesta

successful operation

allowsSensitiveProperties
boolean
requerido

Indica si el tipo de objeto permite propiedades que contienen datos sensibles.

archived
boolean
requerido

Indica si el tipo de objeto está archivado.

fullyQualifiedName
string
requerido

Un ID único asignado para el objeto, que incluye el ID del portal y el nombre del objeto.

id
string
requerido

Un ID único para este tipo de objeto. Se definirá como {meta-type}-{unique ID}.

labels
object
requerido
name
string
requerido

Un nombre único para este objeto. Solo para uso interno.

objectTypeId
string
requerido

Un identificador único para el tipo de objeto.

requiredProperties
string[]
requerido

Los nombres de las propiedades que deben ser obligatorias cuando se cree un objeto de este tipo.

searchableProperties
string[]
requerido

Los nombres de las propiedades que serán indexadas para este tipo de objeto en la búsqueda de productos de HubSpot.

secondaryDisplayProperties
string[]
requerido

Los nombres de las propiedades secundarias de este objeto. Se mostrarán como secundarias en la página de registro de HubSpot para este tipo de objeto.

createdAt
string<date-time>

Cuando se creó el tipo de objeto.

description
string

Una descripción del tipo de objeto.

portalId
integer<int32>

El ID de la cuenta de la que este tipo de objeto es específico.

primaryDisplayProperty
string

El nombre de la propiedad principal de este objeto. Se mostrará como principal en la página de registro de HubSpot para este tipo de objeto.

updatedAt
string<date-time>

Cuando se actualizó por última vez el tipo de objeto.

Last modified on April 13, 2026