Pular para o conteúdo principal
POST
/
crm
/
objects
/
v3
/
{objectType}
Criar
curl --request POST \
  --url https://api.hubapi.com/crm/objects/v3/{objectType} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associations": [
    {
      "to": {
        "id": "<string>"
      },
      "types": [
        {
          "associationCategory": "HUBSPOT_DEFINED",
          "associationTypeId": 123
        }
      ]
    }
  ],
  "properties": {}
}
'
{
  "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

objectType
string
obrigatório

O objectTypeId do tipo de objeto

Corpo

application/json

É o objeto de entrada usado para criar um novo objeto do CRM, contendo as propriedades a serem definidas e associações opcionais para vincular o novo registro com outros objetos do CRM.

associations
object[]
obrigatório
properties
object
obrigatório

Pares de chave-valor para definir propriedades para o novo 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