Pular para o conteúdo principal
PATCH
/
crm
/
v3
/
extensions
/
cards-dev
/
{appId}
/
{cardId}
Atualizar um cartão
curl --request PATCH \
  --url 'https://api.hubapi.com/crm/v3/extensions/cards-dev/{appId}/{cardId}?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actions": {
    "baseUrls": [
      "https://www.example.com/hubspot"
    ]
  },
  "display": {
    "properties": [
      {
        "dataType": "STRING",
        "label": "Pets Name",
        "name": "pet_name"
      }
    ]
  },
  "fetch": {
    "objectTypes": [
      {
        "name": "contacts",
        "propertiesToSend": [
          "email",
          "firstname"
        ]
      }
    ],
    "targetUrl": "https://www.example.com/hubspot/target"
  },
  "title": "PetSpot"
}
'
{
  "actions": {
    "baseUrls": [
      "https://www.example.com/hubspot"
    ]
  },
  "auditHistory": [
    {
      "actionType": "CREATE",
      "applicationId": 123,
      "authSource": "APP",
      "changedAt": 123,
      "initiatingUserId": 123,
      "objectTypeId": 123
    }
  ],
  "display": {
    "properties": [
      {
        "dataType": "BOOLEAN",
        "label": "<string>",
        "name": "<string>",
        "options": [
          {
            "label": "<string>",
            "name": "<string>",
            "type": "DANGER"
          }
        ]
      }
    ]
  },
  "fetch": {
    "objectTypes": [
      {
        "name": "companies",
        "propertiesToSend": [
          "<string>"
        ]
      }
    ],
    "targetUrl": "<string>"
  },
  "id": "<string>",
  "title": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Produtos suportados
Requer um dos seguintes produtos ou superior.
Marketing HubMarketing HubGrátis
Sales HubSales HubGrátis
Service HubService HubGrátis
Content HubContent HubGrátis

Autorizações

hapikey
string
query
obrigatório

Parâmetros de caminho

appId
integer<int32>
obrigatório
cardId
string
obrigatório

Corpo

application/json

Body for a patch with optional fields

actions
object

Configuration for custom user actions on cards.

Exemplo:
{
"baseUrls": ["https://www.example.com/hubspot"]
}
display
object

Configuration for displayed info on a card

fetch
object

Variant of CardFetchBody with fields as optional for patches

title
string

O título de nível superior para este cartão. Exibido para os usuários na UI do CRM.

Resposta

successful operation

actions
object
obrigatório

Configuration for custom user actions on cards.

Exemplo:
{
"baseUrls": ["https://www.example.com/hubspot"]
}
auditHistory
object[]
obrigatório

Uma lista das ações realizadas no cartão, incluindo criação, exclusão e atualizações.

display
object
obrigatório

Configuration for displayed info on a card

fetch
object
obrigatório
id
string
obrigatório

O ID exclusivo do cartão.

title
string
obrigatório

O título de nível superior para este cartão. Exibido para os usuários na UI do CRM.

createdAt
string<date-time>

A data e a hora em que o cartão foi criado.

updatedAt
string<date-time>

A data e a hora da última atualização do cartão.

Last modified on January 23, 2026