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} \
  --header 'Authorization: Bearer <token>' \
  --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"
}

Supported products

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

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 April 13, 2026