Passer au contenu principal
GET
/
crm
/
properties
/
2026-03
/
{objectType}
/
{propertyName}
Lire une propriété
curl --request GET \
  --url https://api.hubapi.com/crm/properties/2026-03/{objectType}/{propertyName} \
  --header 'Authorization: Bearer <token>'
{
  "description": "<string>",
  "fieldType": "<string>",
  "groupName": "<string>",
  "label": "<string>",
  "name": "<string>",
  "options": [
    {
      "hidden": true,
      "label": "<string>",
      "value": "<string>",
      "description": "<string>",
      "displayOrder": 123
    }
  ],
  "type": "<string>",
  "archived": true,
  "archivedAt": "2023-11-07T05:31:56Z",
  "calculated": true,
  "calculationFormula": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "createdUserId": "<string>",
  "currencyPropertyName": "<string>",
  "dataSensitivity": "highly_sensitive",
  "dateDisplayHint": "absolute",
  "displayOrder": 123,
  "externalOptions": true,
  "formField": true,
  "hasUniqueValue": true,
  "hidden": false,
  "hubspotDefined": true,
  "modificationMetadata": {
    "archivable": true,
    "readOnlyDefinition": true,
    "readOnlyValue": true,
    "readOnlyOptions": true
  },
  "numberDisplayHint": "currency",
  "referencedObjectType": "<string>",
  "sensitiveDataCategories": [
    "<string>"
  ],
  "showCurrencySymbol": true,
  "updatedAt": "2023-11-07T05:31:56Z",
  "updatedUserId": "<string>"
}

Supported products

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

objectType
string
requis
propertyName
string
requis

Paramètres de requête

archived
boolean
défaut:false

S'il faut renvoyer uniquement les résultats qui ont été archivés.

dataSensitivity
enum<string>
défaut:non_sensitive
Options disponibles:
highly_sensitive,
non_sensitive,
sensitive
locale
string
properties
string

Réponse

successful operation

Propriété HubSpot

description
string
requis

Une description de la propriété qui sera affichée comme texte d'aide dans HubSpot.

fieldType
string
requis

Contrôle la façon dont la propriété apparaît dans HubSpot.

groupName
string
requis

Le nom du groupe de propriétés auquel appartient la propriété.

label
string
requis

Un libellé de propriété qui sera affichée dans HubSpot lisible par les personnes.

name
string
requis

Le nom interne de la propriété, qui doit être utilisé lorsque la propriété est référencée par le biais de l'API.

options
object[]
requis

Une liste d'options valides pour la propriété. Ce champ est requis pour les propriétés énumérées, mais sera vide pour les autres types de propriétés.

type
string
requis

Le type de données de la propriété.

archived
boolean

Si la propriété est archivée ou non.

archivedAt
string<date-time>

Moment où la propriété a été archivée

calculated
boolean

Pour les propriétés par défaut, vrai indique que la propriété est calculée par un processus HubSpot. Cela n'a aucun effet pour les propriétés personnalisées.

calculationFormula
string

Cela représente une formule utilisée pour calculer une propriété calculée.

createdAt
string<date-time>

Date à laquelle la propriété a été créée, au format ISO 8601.

createdUserId
string

L'ID utilisateur interne de l'utilisateur qui a créé la propriété dans HubSpot. Ce champ peut ne pas exister si la propriété a été créée en dehors de HubSpot.

currencyPropertyName
string

Le nom de la propriété de la devise associée.

dataSensitivity
enum<string>

Indique le niveau de sensibilité de la propriété, par exemple « non_sensitive », « sensitive » ou « highly_sensitive ».

Options disponibles:
highly_sensitive,
non_sensitive,
sensitive
dateDisplayHint
enum<string>

Indique comment les valeurs de date doivent être affichées, avec des options telles que « absolute », « absolute_with_relative », « time_since » ou « time_until ».

Options disponibles:
absolute,
absolute_with_relative,
time_since,
time_until
displayOrder
integer<int32>

Les propriétés sont affichées dans l'ordre croissant en partant de la valeur entière positive la plus basse.

externalOptions
boolean

Par défaut, vrai indique que les options sont stockées en dehors des paramètres de propriété.

formField
boolean

Si la propriété peut être utilisée dans un formulaire HubSpot ou non.

hasUniqueValue
boolean

Si la valeur de la propriété doit être unique ou non. Une fois définie, il n'est pas possible de le modifier.

hidden
boolean

Si la propriété sera masquée de l'interface utilisateur HubSpot ou non. Il est recommandé de laisser la valeur définie sur « faux » pour les propriétés personnalisées.

Exemple:

false

hubspotDefined
boolean

Cette valeur sera « vrai » pour les propriétés d'objet par défaut intégrées dans HubSpot.

modificationMetadata
object
numberDisplayHint
enum<string>

Indication sur la manière dont une propriété numérique est affichée et validée dans l'interface utilisateur de HubSpot. Peut être : « non formaté », « formaté », « devise », « pourcentage », « durée » ou « probabilité ».

Options disponibles:
currency,
duration,
formatted,
percentage,
probability,
unformatted
referencedObjectType
string

Si cette propriété est liée à un ou plusieurs autres objets, ils seront répertoriés ici.

sensitiveDataCategories
string[]

Lorsque sensitiveData est vrai, liste le type de données sensibles contenues dans la propriété (par exemple, « HIPAA »).

showCurrencySymbol
boolean

Si la propriété affiche ou non le symbole de la devise défini dans les paramètres du compte.

updatedAt
string<date-time>

L'horodatage du moment où la propriété a été mise à jour pour la dernière fois, au format ISO 8601.

updatedUserId
string

L'ID utilisateur interne de l'utilisateur qui a mis à jour la propriété dans HubSpot. Ce champ peut ne pas exister si la propriété a été mise à jour en dehors de HubSpot.

Last modified on April 13, 2026