Pular para o conteúdo principal
PATCH
/
crm
/
objects
/
v3
/
{objectType}
/
{objectId}
Atualizar
curl --request PATCH \
  --url https://api.hubapi.com/crm/objects/v3/{objectType}/{objectId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  }
}
'
{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "id": "512",
  "properties": {
    "property_checkbox": "false",
    "property_date": "1572480000000",
    "property_dropdown": "choice_b",
    "property_multiple_checkboxes": "chocolate;strawberry",
    "property_number": "17",
    "property_radio": "option_1",
    "property_string": "value"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

objectId
string
obrigatório

ID do objeto

objectType
string
obrigatório

O objectTypeId do tipo de objeto

Parâmetros de consulta

idProperty
string

O nome de uma propriedade cujos valores são exclusivos para este tipo de objeto

Corpo

application/json

Representa a entrada necessária para criar ou atualizar um objeto do CRM, contendo um objeto com nomes de propriedades e seus valores correspondentes.

properties
object
obrigatório

Pares de chave-valor que representam as propriedades do objeto.

Resposta

successful operation

Um objeto público simples.

archived
boolean
obrigatório

Se o objeto está arquivado ou não.

createdAt
string<date-time>
obrigatório

A data e hora em que o objeto foi criado, no formato ISO 8601.

id
string
obrigatório

O ID exclusivo do objeto.

properties
object
obrigatório

Pares de chave-valor que representam as propriedades do objeto.

updatedAt
string<date-time>
obrigatório

A data e hora em que o objeto foi atualizado pela última vez, no formato ISO 8601.

archivedAt
string<date-time>

A data e hora em que o objeto foi arquivado, no formato ISO 8601.

objectWriteTraceId
string

Identificador exclusivo para cada operação de gravação, que será retornado juntamente com quaisquer erros para identificar qual solicitação encontrou qual erro.

propertiesWithHistory
object

Pares de chave-valor que representam as propriedades do objeto junto com seu histórico.

url
string

URL para acessar o objeto

Last modified on March 24, 2026