Zum Hauptinhalt springen
PATCH
/
crm
/
v3
/
extensions
/
cards-dev
/
{appId}
/
{cardId}
Eine Karte aktualisieren
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"
    ]
  },
  "createdAt": "2019-10-30T03:30:17.883Z",
  "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",
  "updatedAt": "2019-11-30T03:30:17.883Z"
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

hapikey
string
query
erforderlich

Pfadparameter

appId
integer<int32>
erforderlich

Die ID der Ziel-App.

cardId
string
erforderlich

Die ID der zu aktualisierenden Karte

Body

application/json

Card definition fields to be updated.

Body for a patch with optional fields

actions
object

Configuration for custom user actions on cards.

Beispiel:
{
"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

Der Top-Level-Titel für diese Karte. Wird den Benutzern in der CRM-UI angezeigt.

Antwort

successful operation

actions
object
erforderlich

Configuration for custom user actions on cards.

Beispiel:
{
"baseUrls": ["https://www.example.com/hubspot"]
}
auditHistory
object[]
erforderlich

Eine Liste der auf der Karte durchgeführten Aktionen, einschließlich Erstellung, Löschung und Aktualisierungen.

display
object
erforderlich

Configuration for displayed info on a card

fetch
object
erforderlich
id
string
erforderlich

Die eindeutige ID der Karte.

title
string
erforderlich

Der Top-Level-Titel für diese Karte. Wird Benutzern in der CRM-UI angezeigt.

createdAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die Karte erstellt wurde.

updatedAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die Karte zuletzt aktualisiert wurde.

Last modified on December 10, 2025